2014-04-24 18:48:22 -04:00
|
|
|
# External issue tracker
|
|
|
|
|
|
2019-03-21 22:39:00 -04:00
|
|
|
GitLab has a great [issue tracker](../user/project/issues/index.md) but you can also use an external one
|
|
|
|
|
such as Jira, Redmine, YouTrack, or Bugzilla. External issue trackers are configurable per GitLab project.
|
2014-01-24 06:09:33 -05:00
|
|
|
|
2019-03-21 23:54:08 -04:00
|
|
|
Once configured, you can reference external issues using the format `CODE-123`, where:
|
|
|
|
|
|
|
|
|
|
- `CODE` is a unique code for the tracker.
|
|
|
|
|
- `123` is the issue number in the tracker.
|
|
|
|
|
|
|
|
|
|
These references in GitLab merge requests, commits, or comments are automatically converted to links to the issues.
|
2015-02-18 23:49:19 -05:00
|
|
|
|
2019-03-21 22:39:00 -04:00
|
|
|
You can keep GitLab's issue tracker enabled in parallel or disable it. When enabled, the **Issues** link in the
|
|
|
|
|
GitLab menu always opens the internal issue tracker. When disabled, the link is not visible in the menu.
|
2017-07-24 02:14:06 -04:00
|
|
|
|
2015-02-12 20:06:55 -05:00
|
|
|
## Configuration
|
|
|
|
|
|
2016-01-08 06:43:33 -05:00
|
|
|
The configuration is done via a project's **Services**.
|
2015-02-12 20:06:55 -05:00
|
|
|
|
2016-01-08 06:43:33 -05:00
|
|
|
### Project Service
|
2015-02-12 20:06:55 -05:00
|
|
|
|
2016-01-08 06:43:33 -05:00
|
|
|
To enable an external issue tracker you must configure the appropriate **Service**.
|
|
|
|
|
Visit the links below for details:
|
2015-02-12 20:06:55 -05:00
|
|
|
|
2017-02-03 13:41:35 -05:00
|
|
|
- [Redmine](../user/project/integrations/redmine.md)
|
2019-02-18 12:08:36 -05:00
|
|
|
- [YouTrack](../user/project/integrations/youtrack.md)
|
2017-02-03 13:41:35 -05:00
|
|
|
- [Jira](../user/project/integrations/jira.md)
|
|
|
|
|
- [Bugzilla](../user/project/integrations/bugzilla.md)
|
2017-11-21 10:21:50 -05:00
|
|
|
- [Custom Issue Tracker](../user/project/integrations/custom_issue_tracker.md)
|
2015-02-12 20:06:55 -05:00
|
|
|
|
|
|
|
|
### Service Template
|
|
|
|
|
|
2016-01-08 06:43:33 -05:00
|
|
|
To save you the hassle from configuring each project's service individually,
|
|
|
|
|
GitLab provides the ability to set Service Templates which can then be
|
|
|
|
|
overridden in each project's settings.
|
2015-04-26 19:44:22 -04:00
|
|
|
|
2017-02-03 13:41:35 -05:00
|
|
|
Read more on [Services Templates](../user/project/integrations/services_templates.md).
|
