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.
First, create the stream you'd like to use for Redmine notifications,
and subscribe all interested parties to this stream. We recommend the
name redmine
.
Then:
Clone the Zulip Redmine plugin repository by running:
git clone https://github.com/zulip/zulip-redmine-plugin
Follow the
Redmine plugin installation guide
to install the zulip_redmine
plugin directory, which is a
subdirectory of the zulip-redmine-plugin
repository
directory. In a nutshell, the steps are:
Copy the zulip_redmine
directory to
the plugins
directory of your Redmine
instance.
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
Restart your Redmine instance.
The Zulip plugin is now registered with Redmine!
On your {{ settings_html|safe }}, create a new Redmine bot.
To configure Zulip notification settings that apply to many projects in one go, in Redmine click the "Administration" link in the top left. Click the "Plugins" link on the Administration page, and click the "Configure" link to the right of the Zulip plugin description. In the "Projects" section, select all projects to which you want these settings to apply.
To configure Zulip notifications for a particular Redmine project, visit the project's Settings page.
In either case, fill out zulip server by {{ external_api_path_subdomain }}
,
the bot email address, and API key, and the
Zulip stream that should receive notifications. Apply your changes.
To test the plugin, create an issue or update an existing issue in a Redmine project that has Zulip notifications configured (any project, if you've configured global settings).
Congratulations! You're done!
When you update issues in
Redmine, the team can see these updates in real time in Zulip: