Skip to content
Redmine Plugin to integrate it with Pivotal Tracker
Ruby HTML JavaScript
Find file
Latest commit 41ab501 @pbrudny pbrudny Merge pull request #2 from pbrudny/master
Upgraded to work with latest version of Redmine and Pivotal Tracker


Redmine Trackmine Plugin

Redmine is an excellent multi-project issue tracking tool focussing on collaboration in the implementation and integration parts of software development. Pivotal Tracker, on the other hand, is a superb planning tool and extremely well suited for requirements capturing and customer feedback.

The Trackmine plugin provides simple but effective bi-directional communication between Pivotal Tracker and Redmine by outsourcing the workflow between Pivotal's “Started” and “Finished” states to Redmine. The triggers for teleporting between the tools are starting a story in Pivotal and closing an issue in Redmine. The workflow in Redmine remains customizable and can be tailored to individual needs. Step by step configuration tutorial

UPGRADED to work with Pivotal Tracker API v5 and Redmine 3


  • Starting a story in a Pivotal Tracker automatically creates a Redmine issue with status “Accepted”.

  • Updating a story in a Pivotal Tracker updates the Redmine issue attributes (subject, description, status).

  • Closing a Redmine issue finishes the Pivotal Tracker story.

  • Mapping between Pivotal Tracker and Redmine attributes can be configured



In Redmine app run:

$ bin/plugin install

or clone it into /vendor/plugins/

$ git clone

Install gems

$ bundle install

Run plugin migrations

$ rake redmine:plugins:migrate

Configuration- Redmine side

Make sure you have following custom fields for Redmine Issue:

  • 'Pivotal Project ID' (field_format: int, Trackers: Bug, Support, Feature) .

  • 'Pivotal Story ID' (field_format: int, Trackers: Bug, Support, Feature) .

And there is IssueStatus 'Accepted'

Add valid Pivotal Tracker credentials in [redmine_app]/config/trackmine.yml


  email: [pivotal_tracker_email]
  password: [pivotal_tracker_password]

  # You can use an api token or email/password for the PT api.
  token: [pivotal_tracker_api_token]

  recipient: [email_for_error_notifications]
  from: "[information to emails FROM field]"

  token: 1234
  password: 2222

  password: 1234

  from: "Trackmine Notifications <>"

Users mentioned in trackmine.yml should have administration rights in redmine. The user named 'super_user' should have access to all Pivotal Tracker projects you want to map to. It might be the Pivotal Tracker admin. Its credentials are used to handle Pivotal Tracker hooks.

Configuration- Pivotal Tracker side

Add Web Hook Url pointing to your Redmine app. To do that:

  • On your project page choose 'Project -> Configure Integrations'

  • Find Activity Web Hook section

  • In 'Web Hook Url' put [redmine_app_url]/pivotal_activity.json




  • As a Redmine administrator go to 'Administration -> Trackmine' section.

  • Use link 'Add mapping'

  • Select Redmine project and Pivotal project (or label)

Mapping Configuration

You can configure:

  • Mapping between Pivotal story estimation points and Redmine estimated_hours


1 point  => 1 hour
2 points => 4 hours
3 points => 10 hours
  • Mapping between Pivotal story_types and Redmine trackers


'feature'  => 'Feature'
'bug'      => 'Bug'
'chore'    => 'Support'


Trackmine has RSpec test coverage. Run specs with:

rake redmine:plugins:test


Copyright © 2010-2015 Capita Unternehmensberatung GmbH. See LICENSE for details.

Something went wrong with that request. Please try again.