Get information on new or updated Redmine issues right in Zulip with our Zulip Redmine plugin!

Note: this setup must be done by a Redmine Administrator.

Installing

Following the Redmine plugin installation guide:

1. Start by changing to the Redmine instance root directory: cd /path/to/redmine/instance

2. Clone the Zulip Redmine plugin repository into the plugins subdirectory of your Redmine instance. git clone https://github.com/zulip/zulip-redmine-plugin plugins/redmine_zulip

3. Update the Redmine database by running (for Rake 2.X, see the guide for instructions for older versions): rake redmine:plugins:migrate RAILS_ENV=production

4. Restart your Redmine instance.

The Zulip plugin is now registered with Redmine!

Global settings

1. Create a bot for Redmine. Make sure that you select Incoming webhook as the Bot type.

2. Log in to your Redmine instance, click on Administration in the top-left corner, then click on Plugins.

3. Find the Redmine Zulip plugin, and click Configure. Fill out the following fields:

   • Zulip URL (e.g https://chat.zulip.org)
   • Zulip Bot E-mail
   • Zulip Bot API key
   • Stream name *
   • Issue updates subject *
   • Version updates subject *

   * You can use the following variables in these fields:

   • ${issue_id}
   • ${issue_subject}
   • ${project_name}
   • ${version_name}

Project settings

To override the global settings for a specific project, go to the project's Settings page, and select the Zulip tab.

You're done! Your Redmine notifications may look like this: