Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
Go to start of metadata

Plugin Information

View Redmine on the plugin site for more information.

Redmine Plugin

This plugin integrates Redmine into Jenkins (there's a plugin for Redmine that integrates Jenkins from the Redmine side, too.)Redmine is a flexible project management web application.
This plugin decorates Hudson "Changes" HTML to create links to your Redmine ticket.
As an example, if you committed a change with the following log message:

refs 123

Keyword that can be used( nnn is ticket number)

  • refs nnn
  • references nnn
  • IssueID nnn
  • fixes nnn
  • closes nnn
  • #nnn
  • refs nnn,nnn,nnn

Redmine REST API

This plugin uses Redmine REST API - to enable it, login into your Redmine, navigate to Administration -> Settings -> Authentication, check "Enable REST web service" and Save.

To use "Aggregate Redmine ticket metrics" you should provide API key assigned to existing Redmine user. Login as desired user, visit http://redmine/my/account, copy key from "API access key" and paste it into job on Jenkins.


Version 0.21 (2017/08/20)

  • JENKINS-39887 - redmine plugin crashes blue ocean show more link - thanks @i386
  • Fix typo in help files - thanks @kryger
  • Add Jenkinsfile to the plugin - thanks @ljader

Version 0.20 (2016/10/25)

  • Encrypt db password and API key using Secret class - thanks @ljader
  • Allow empty Redmine version, which assumes latest version - thanks @yoichi
  • Look for a project by it's identifier and then by name - thanks @eivindt and @deveth0
  • Improve description of fields in help files - thanks @ljader
  • Improve handling of self-signed Redmine sites - thanks @deveth0 and @ljader

Version 0.15 (2013/08/31)

Ths version is NOT compatibile with previous version - jobs need to be reconfigured. Sorry!

  • Redmine websites are now globally configured and only referenced in job settings - thanks @ljader
  • Redmine Repository browser path problem - thanks @ando-masaki & @yoichi
  • PostgreSQL isField fix - thanks @akallabeth

Version 0.13 (2013/04/30)

  • Workaround to fix error with https connection
  • add redmine user auth

Version 0.12 (2013/04/14)

  • include project name in redmine link
  • improve error message on invalid project name

Version 0.11 (2012/10/28)

  • support latest redmine ( fix ticket url bug )
  • add RedmineMetrics function

Version 0.10

  • move github

Version 0.9 (2010/10/11)

Version 0.8 (2009/12/28)

  • Update uses of deprecated APIs

Version 0.7 (2009/03/08)

  • compliant Redmine 0.8.1
  • don't link to #1,#2,#3 style bug fix

Version 0.6 (2008/12/23)

  • don't link to redmine repository at repository browser

Version 0.5 (2008/12/07)

  • compliant ticket number delimiter by &
  • don't use repository browser bug fix

Version 0.4 (2008/11/19)

  • compliant ticket number delimiter by ,

Version 0.3 (2008/11/09)

  • add matching keyword fixes and closes

Version 0.2 (2008/11/04)

  • first release

Ruby Logo

This plugin use ruby offical logo.
Copyright (C) 2008 Ruby Association LLC


  1. Unknown User (larrycai)

    For the commit message, if there is comments after issue number in same line, it doesn't work.

    I created two test case and verified it.

        // failed for comment in same line
        public void testWikiLinkSyntaxCommentInSameline() {
            assertAnnotatedTextEquals("refs #1 comment", 
                    "<a href='" + REDMINE_URL + "issues/show/1'>refs #1 comment</a>");
        // passed if multiline and no comments after NUM (#1)
        public void testWikiLinkSyntaxMultiline() {
            assertAnnotatedTextEquals("refs #1\n comment", 
                    "<a href='" + REDMINE_URL + "issues/show/1'>refs #1</a><br> comment");

    I created bug issue JENKINS-8760

    1. Unknown User (manuel_j)

      Did you find a workaround to use the issue linking part of this nice plugin anyway?
      Because even if I add a new line in our version control system (MKS), in jenkins there is only one line and thus no linking to redmine.



  2. Unknown User (cforce)

    If some use other keywords its failing.

  3. Unknown User (cforce)

    Very nice post. We use edmine and jenkins too, and the Redmine Plugin (https://wiki.jenkins-ci.org/display/JENKINS/Redmine+Plugin) does not fullfill the features you describe here. You talking about the Jira Plugin (https://wiki.jenkins-ci.org/display/JENKINS/JIRA+Plugin), but ur schreenshots looks like you adopted this . WOuld be realy great if yu can send or link ur repository with changes/fork here. I reaaly would like to inspect that further.
    Sadly the e Redmine Plugin (https://wiki.jenkins-ci.org/display/JENKINS/Redmine+Plugin) seems to be outdated and has many drawbacks,- e.h i have to configure base urls for every project agaijn and also there is no default for redmine project id (= job_name_pattern)
    Tx for contributing!
    We use edmine and jenkins too, and the Redmine Plugin (https://wiki.jenkins-ci.org/display/JENKINS/Redmine+Plugin) sadly does not fullfill the features described here http://codeslife.com/2011/02/24/associate-ci-build-information-in-redmine-issue-by-using-redmine-rest-api/comment-page-1/#comment-1205. The Jira Plugin (https://wiki.jenkins-ci.org/display/JENKINS/JIRA+Plugin) is good example how redmine could be suppported . WOuld be realy great if this plugin has more envolvement. A look at the tracker (https://issues.jenkins-ci.org/secure/IssueNavigator.jspa?mode=hide&reset=true&jqlQuery=project+%3D+JENKINS+AND+status+in+%28Open%2C+%22In+Progress%22%2C+Reopened%29+AND+component+%3D+'redmine') shows nearly no activity !

    Sadly the Plugin seems to be outdated (not compativle with redmine 1.2.2) and has many drawbacks, e.g you have to configure base urls for every project again and also there is no default for redmine project id set (e.g. job_name_pattern like    "(.+)-.*" )

    Tx for contributing anyway.

  4. Unknown User (ufalak)

    Its not possible to use Redmine Plugin on Jenkins Pipelines? Only in jobs?