summaryrefslogtreecommitdiff
path: root/doc/user/project/services/external_issue_tracker.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/user/project/services/external_issue_tracker.md')
-rw-r--r--doc/user/project/services/external_issue_tracker.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/doc/user/project/services/external_issue_tracker.md b/doc/user/project/services/external_issue_tracker.md
new file mode 100644
index 00000000000..fcb9b639a8b
--- /dev/null
+++ b/doc/user/project/services/external_issue_tracker.md
@@ -0,0 +1,31 @@
+# External issue tracker
+
+GitLab has a great issue tracker but you can also use an external one such as
+Jira, Redmine, or Bugzilla. Issue trackers are configurable per GitLab project and allow
+you to do the following:
+
+- the **Issues** link on the GitLab project pages takes you to the appropriate
+ issue index of the external tracker
+- clicking **New issue** on the project dashboard creates a new issue on the
+ external tracker
+
+## Configuration
+
+The configuration is done via a project's **Services**.
+
+### Project Service
+
+To enable an external issue tracker you must configure the appropriate **Service**.
+Visit the links below for details:
+
+- [Redmine](redmine.md)
+- [Jira](jira.md)
+- [Bugzilla](bugzilla.md)
+
+### Service Template
+
+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.
+
+Read more on [Services Templates](../../admin_area/services_templates.md).