etcd-based peer discovery backend for RabbitMQ 3.7.0+
Clone or download
lukebakken Merge pull request #16 from rabbitmq/cuttlefish-lock-timeout-alias
Alias cluster_formation.etcd.lock_timeout to cluster_formation.etcd.lock_wait_time
Latest commit adfbdc4 Oct 9, 2018

RabbitMQ Peer Discovery Etcd

This is an etcd-based implementation of RabbitMQ peer discovery interface (new in 3.7.0, previously available in the rabbitmq-autocluster plugin by Gavin Roy).

This plugin only performs peer discovery and most basic node health monitoring using etcd as a data source. Please get familiar with RabbitMQ clustering fundamentals before attempting to use it.

While it may seem at times that this is a RabbitMQ cluster management solution, it is not. Cluster provisioning and most of Day 2 operations such as proper monitoring are not in scope for this plugin.

Supported RabbitMQ Versions

This plugin requires RabbitMQ 3.7.0 or later.

For an etcd-based peer discovery and cluster formation mechanism that supports 3.6.x, see rabbitmq-autocluster.

Supported etcd Versions

The plugin supports etcd v2 and v3.


This plugin ships with RabbitMQ as of 3.7.0. There is no need to install it separately. Enable the plugin in offline mode before the node is first started:

rabbitmq-plugins --offline enable rabbitmq_peer_discovery_etcd


See RabbitMQ Cluster Formation guide.


See and our development process overview.


Licensed under the MPL, same as RabbitMQ server.


(c) Pivotal Software Inc., 2007-2018.