Thank you to all the people building the future with us.

Read More

Installing Additional Plugins

Any plugins that do not ship with the server will need to be installed as .ez archives by copying them to one of the plugins directories specified by $RABBITMQ_PLUGINS_DIR. Once they have been copied to the correct directory, they will show up in rabbitmq-plugins list and can be enabled with rabbitmq-plugins enable plugin-name.

The plugins directory location is determined by the RABBITMQ_PLUGINS_DIR variable. Its default value depends on how you installed RabbitMQ. Some common values are:

Installation methodPlugins directory
Debian/RPM packages /usr/lib/rabbitmq/plugins and /usr/lib/rabbitmq/lib/rabbitmq_server-version/plugins

/usr/lib/rabbitmq/plugins is an additional directory where nothing is installed by the RabbitMQ package itself. But it is a fixed non-changing path where external plugins can be installed from Debian/RPM packages or can be put there by a provisioning tool.

Windows Typically C:\Program Files\RabbitMQ\rabbitmq_server-version\plugins (depending on where it was installed)
Homebrew /usr/local/Cellar/rabbitmq/version/plugins
Generic Unix rabbitmq_server-version/plugins (depending on where it was installed)

Plugins and Upgrades

The enabled plugins configuration is preserved between upgrades, so there is no need to re-enable plugins after an upgrade, but because the plugins directory changes between versions, any third party plugins will need to be copied to the new directory. It's very possible that due to API changes you may need to check for updates to third party plugins at this point.

Building Plugins

You can also build RabbitMQ plugins from source. The sources for a particular version of the plugins is distributed in the same archive as the broker with that version. The source code repositories can all be found on GitHub. See the plugin development guide for more information on building plugins from source.

Note that plugins tend to be strongly bound to a particular version of rabbitmq-server. For example, if you are running RabbitMQ 3.7.4, you should check out all plugins with the Git tag v3.7.4.

Getting Help and Providing Feedback

If you have questions about the contents of this guide or any other topic related to RabbitMQ, don't hesitate to ask them on the RabbitMQ mailing list.

Documentation feedback is also very welcome on the list. If you'd like to contribute an improvement to the site, its source is available on GitHub.