summaryrefslogtreecommitdiff
path: root/doc/integration/external-issue-tracker.md
blob: 6245836bef1846d025b9536dc39815cce8e4e66e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
# External issue tracker

GitLab has a great issue tracker but you can also use an external issue tracker such as JIRA or Redmine. This is something that you can turn on per GitLab project. If for example you configure JIRA it provides the following functionality:

- the 'Issues' link on the GitLab project pages takes you to the appropriate JIRA issue index;
- clicking 'New issue' on the project dashboard creates a new JIRA issue;
- To reference JIRA issue PROJECT-1234 in comments, use syntax PROJECT-1234. Commit messages get turned into HTML links to the corresponding JIRA issue.

![jira screenshot](jira-integration-points.png)

You can configure the integration in the gitlab.yml configuration file.

Support to add your commits to the Jira ticket automatically is [available in GitLab EE](http://doc.gitlab.com/ee/integration/jira.html).