2014-04-24 22:48:22 +00:00
|
|
|
# External issue tracker
|
|
|
|
|
2019-03-22 02:39:00 +00: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 11:09:33 +00:00
|
|
|
|
2019-03-22 03:54:08 +00: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-19 04:49:19 +00:00
|
|
|
|
2019-03-22 02:39:00 +00: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 06:14:06 +00:00
|
|
|
|
2015-02-13 01:06:55 +00:00
|
|
|
## Configuration
|
|
|
|
|
2016-01-08 11:43:33 +00:00
|
|
|
The configuration is done via a project's **Services**.
|
2015-02-13 01:06:55 +00:00
|
|
|
|
2016-01-08 11:43:33 +00:00
|
|
|
### Project Service
|
2015-02-13 01:06:55 +00:00
|
|
|
|
2016-01-08 11:43:33 +00:00
|
|
|
To enable an external issue tracker you must configure the appropriate **Service**.
|
|
|
|
Visit the links below for details:
|
2015-02-13 01:06:55 +00:00
|
|
|
|
2017-02-03 18:41:35 +00:00
|
|
|
- [Redmine](../user/project/integrations/redmine.md)
|
2019-02-18 17:08:36 +00:00
|
|
|
- [YouTrack](../user/project/integrations/youtrack.md)
|
2017-02-03 18:41:35 +00:00
|
|
|
- [Jira](../user/project/integrations/jira.md)
|
|
|
|
- [Bugzilla](../user/project/integrations/bugzilla.md)
|
2017-11-21 15:21:50 +00:00
|
|
|
- [Custom Issue Tracker](../user/project/integrations/custom_issue_tracker.md)
|
2015-02-13 01:06:55 +00:00
|
|
|
|
|
|
|
### Service Template
|
|
|
|
|
2016-01-08 11:43:33 +00: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 23:44:22 +00:00
|
|
|
|
2017-02-03 18:41:35 +00:00
|
|
|
Read more on [Services Templates](../user/project/integrations/services_templates.md).
|