Redmine integration setup guide

Overview

BugHerd's integration with Redmine will allow you to sync BugHerd tasks to Redmine Issues. The Redmine integration can be setup as bi-directional. If you configure the BugHerd Web Hook, then when a BugHerd synced issue is modified in Redmine, it will be updated in BugHerd as well.

Because Redmine and BugHerd's bug statuses and priorities are different from Redmine, you can fully customise the mappings.

How it works

When the integration has been setup fully, here's the information that is synchronised:

Once BugHerd has verified your token, click save to go to the next page. Here you will be able to configure your status and priority mapping. Note: you may skip this step if you do not yet have a good grasp of how you wish to incorporate BugHerd into your process, you can come back here any time from the main integrations screen any time.

Now that your Redmine integration has been created, you can start connecting BugHerd projects you own to your Redmine projects. Please create a BugHerd project if you do not own any projects yet. To start connecting projects, click on the projects link on the Redmine integration:

On the projects screen, pick a BugHerd project you own from the dropdown on the left, and a Redmine project from the one on the right. Then to connect the projects, click add:

Note that any Redmine project you select must contain the "Bug" tracker, please enable it in order for BugHerd to be able to create issues. This is because all bugs will be synced to tracker "Bug":

Once you have created the link between the projects, BugHerd will start syncing any new bugs to Redmine. If you also would like to synchronise any changes made to BugHerd created issues back, you need to setup the Web Hook. Click configure next to the Redmine project. The Web Hook configuration dialog will appear:

Copy the unique key provided and paste it into field BugHerd Project Key on the Redmine project's Settings page:

Note: the field BugHerd Project Key should have been created as part of the setup steps when installing and configuring the plugin.

Once you have clicked save in the Redmine project settings, you can verify that the key works using the verification link on the configuration dialog. If you see a message web hook is active, congratulations, your setup is complete! Now if you create or update a task in BugHerd, you will see the change in your Redmine project under the Issues tab.

If you experience any issues, help is only a quick message away, please open a support ticket and we'll get back to you as soon as possible.