Redmine Service
-
To enable the Redmine integration in a project, navigate to the Integrations page, click the Redmine service, and fill in the required details on the page as described in the table below.
Field Description description
A name for the issue tracker (to differentiate between instances, for example) project_url
The URL to the project in Redmine which is being linked to this GitLab project issues_url
The URL to the issue in Redmine project that is linked to this GitLab project. Note that the issues_url
requires:id
in the URL. This ID is used by GitLab as a placeholder to replace the issue number.new_issue_url
This is the URL to create a new issue in Redmine for the project linked to this GitLab project. This is currently not being used and will be removed in a future release. Once you have configured and enabled Redmine you’ll see the Redmine link on the GitLab project pages that takes you to the appropriate Redmine project.
As an example, below is a configuration for a project named
gitlab-ci
. -
To disable the internal issue tracking system in a project, navigate to the General page, expand the permissions section and switch the Issues toggle to disabled.
Referencing issues in Redmine
Issues in Redmine can be referenced in two alternative ways:
-
#<ID>
where<ID>
is a number (example#143
). -
<PROJECT>-<ID>
where<PROJECT>
starts with a capital letter which is then followed by capital letters, numbers or underscores, and<ID>
is a number (exampleAPI_32-143
).
We suggest using the longer format if you have both internal and external issue trackers enabled. If you use the shorter format and an issue with the same ID exists in the internal issue tracker the internal issue will be linked.
Please note that <PROJECT>
part is ignored and links always point to the
address specified in issues_url
.
Help and feedback
If there's something you don't like about this feature
To propose functionality that GitLab does not yet offer
To further help GitLab in shaping new features
If you didn't find what you were looking for
If you want help with something very specific to your use case, and can use some community support
POST ON GITLAB FORUM
If you have problems setting up or using this feature (depending on your GitLab subscription)
REQUEST SUPPORT
To view all GitLab tiers and features or to upgrade
If you want to try all features available in GitLab.com
If you want to try all features available in GitLab self-managed
If you spot an error or a need for improvement and would like to fix it yourself in a merge request
EDIT THIS PAGE
If you would like to suggest an improvement to this doc