Skip to main content

Running RabbitMQ in Docker: A Comprehensive Guide

Introduction​

Docker provides a convenient way to run RabbitMQ without the need to manually install and configure RabbitMQ on your local machine or server. By using Docker, you can easily deploy RabbitMQ in an isolated container environment, which simplifies setup, testing, and scaling. This guide will walk you through the process of running RabbitMQ in Docker, including setting up a single node and a cluster.

Building webhooks?
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: Development and Testing​

Running RabbitMQ in Docker is ideal for development and testing environments. It allows developers to quickly spin up RabbitMQ instances without worrying about affecting the local environment or dealing with complex installation procedures.

Building webhooks?
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!

Step-by-Step Guide with Code Samples​

Prerequisites​

  • Docker installed on your machine. If you haven't installed Docker, you can download it from Docker's website.

Step 1: Pulling the RabbitMQ Docker Image​

Pull the official RabbitMQ image:

docker pull rabbitmq:3-management

This command pulls the RabbitMQ image with the management plugin enabled, which provides a web-based UI for managing your RabbitMQ server.

Step 2: Running a RabbitMQ Container​

  1. Start a RabbitMQ instance:
docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:3-management
  • -d runs the container in detached mode.
  • --name assigns a name to the container.
  • -p maps the ports from the container to your host machine. Port 5672 is for RabbitMQ server, and 15672 is for the management UI.
  1. Access the RabbitMQ Management Console:
  • Open a web browser and navigate to http://localhost:15672/.
  • Log in with the default username guest and password guest.

Step 3: Configuring RabbitMQ in Docker​

You can mount a custom configuration file from your host to the container.

docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 -v /path/to/your/rabbitmq.conf:/etc/rabbitmq/rabbitmq.conf rabbitmq:3-management

Step 4: Setting Up a RabbitMQ Cluster in Docker​

  1. Create a Docker network:
docker network create rabbitmq_cluster
  1. Start RabbitMQ instances on the network:
docker run -d --name rabbitmq1 --hostname rabbitmq1 --network rabbitmq_cluster rabbitmq:3-management
docker run -d --name rabbitmq2 --hostname rabbitmq2 --network rabbitmq_cluster rabbitmq:3-management
  1. Cluster the nodes:

First, access the shell of one of the containers:

docker exec -it rabbitmq1 bash

Then, cluster the nodes using rabbitmqctl:

rabbitmqctl stop_app
rabbitmqctl reset
rabbitmqctl join_cluster rabbit@rabbitmq2
rabbitmqctl start_app

Exit the container shell and repeat for other nodes if necessary.

  1. Verify the cluster status:

Access the shell of one of the nodes as before and run:

rabbitmqctl cluster_status

Step 5: Persisting Data​

To persist data, you can mount a volume to the RabbitMQ container.

docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 -v /path/to/data:/var/lib/rabbitmq rabbitmq:3-management

Conclusion​

Running RabbitMQ in Docker simplifies the process of setting up and managing RabbitMQ instances, especially in development and testing environments. By following the steps outlined in this guide, you can quickly get RabbitMQ running in Docker, configure it according to your needs, and even set up a RabbitMQ cluster.

Remember, while Docker is excellent for development and testing, consider the specifics of your production environment before deploying RabbitMQ in Docker in a production setting.