Skip to main content

Comprehensive Guide to Setting Up and Managing a RabbitMQ Cluster


RabbitMQ is a widely used open-source message broker software. In a production environment, setting up RabbitMQ in a cluster configuration is crucial for achieving high availability and scalability. A RabbitMQ cluster is a group of RabbitMQ nodes that share users, queues, exchanges, bindings, runtime parameters, and other distributed state. This guide covers the steps to set up a RabbitMQ cluster, manage it, and ensure its high availability.

Svix is the enterprise ready webhooks sending service. With Svix, you can build a secure, reliable, and scalable webhook platform in minutes. Looking to send webhooks? Give it a try!

Use Case: High-Availability Messaging System

Consider an application that requires a high-availability messaging system to ensure message delivery even in the case of node failures. A RabbitMQ cluster suits this use case by providing redundancy and load balancing, thereby reducing the risk of message loss and improving the system's overall reliability.

Step-by-Step Guide with Code Samples


  • Two or more machines (physical or virtual) running a compatible OS (e.g., Linux/Unix, Windows).
  • RabbitMQ installed on all machines.
  • Network connectivity between all machines.

Step 1: Install RabbitMQ

  1. Install RabbitMQ on all nodes: Follow the official installation guide to install RabbitMQ on all machines that will form the cluster.

Step 2: Configure Hostnames

  1. Set hostnames:

    • Each node in the cluster should have a unique hostname.
    • Update /etc/hosts or your DNS system so that each machine can resolve the hostnames of all other machines.
    # Example /etc/hosts entries rabbitmq-node1 rabbitmq-node2

### Step 3: Set Up RabbitMQ Nodes

Start RabbitMQ on all nodes:

rabbitmq-server start

Optionally, enable the RabbitMQ management plugin (highly recommended):

rabbitmq-plugins enable rabbitmq_management

Step 4: Forming the Cluster

Stop RabbitMQ on nodes that will join the cluster (except the first node):

rabbitmqctl stop

Join each node to the cluster. On each node (except the first one), run:

rabbitmqctl stop_app
rabbitmqctl reset
rabbitmqctl join_cluster rabbit@rabbitmq-node1
rabbitmqctl start_app

Replace rabbitmq-node1 with the hostname of the node you want to join.

Verify the cluster status:

rabbitmqctl cluster_status

Step 5: Configure High Availability

To ensure high availability, you can set up queue mirroring across nodes.

rabbitmqctl set_policy ha-all "^" '{"ha-mode":"all"}'

This command sets a policy named ha-all that mirrors all queues across all nodes.

Step 6: Testing the Cluster

To test the cluster, publish and consume messages to ensure they are correctly routed within the cluster.

To test failover, stop RabbitMQ on one node and observe if the system continues to operate normally.


Setting up a RabbitMQ cluster is essential for creating a high-availability messaging system. By following these steps, you can create a RabbitMQ cluster that ensures message delivery even in the event of individual node failures. Regular monitoring and management of the cluster are crucial to maintain its health and performance.

This guide provides a foundation for RabbitMQ clustering and can be adapted to suit specific requirements such as larger clusters, different network setups, or integration with other tools and applications.