RabbitMQ Docker

This repository is for RabbitMQ setup with docker compose and how to enable MQTT plugin.

Run Docker with Default Config

To run RabbitMQ on your local machine, you need to clone the repo and start it.

git clone https://github.com/riotu-lab/rabbitmq-docker.git
cd rabbitmq-docker
docker-compose up -d

Now RabbitMQ server is up and running and you can start using it, using the default port 5672 and the default username guest and password guest.
you can open RabbitMQ Management dashboard on http://localhsot:15672

WARNING: These settings is not secure to be deployed to production, please check this production deployment checklist from the the official documentation.

Below steps is not needed for local machine development with AMQP, if MQTT is needed please check RabbitMQ MQTT Plugin

Exporting definitions.json (Optional)

This is an optional step, by default definitions.json is empty.
definitions.json file contains your custom configuration for example, remove default user guest. To get definitions.json file, follow these steps.

• Run docker-compose up
• From browser access this url localhost:15672 and use default credentials username guest and password guest.
• Make custom changes you want (i.e. create new exchange, add new users, remove default user guest, etc...)
• Go to Overview tab and then click on Export definitions then click on Download
• Rename file to definitions.json copy file to rabbitmq/etc/ folder
• Restart docker-compose

Configure RabbitMQ

RabbitMQ configuration file can be found in rabbitmq/etc/rabbitmq.conf

RabbitMQ MQTT Plugin

rabbitmq/etc/enabled_plugins contains rabbitmq_mqtt and rabbitmq_web_mqtt to enable RabbitMQ support for MQTT.
The following configuration is required to configure MQTT plugin

Note: make sure of setting mqtt.exchange is the same exchange you are using in the RabbitMQ client (producer/publisher).

mqtt.listeners.tcp.default = 1883
web_mqtt.tcp.port = 15675

mqtt.allow_anonymous  = true

mqtt.exchange         = psu
# 24 hours by default
mqtt.subscription_ttl = 86400000
mqtt.prefetch         = 10

References

• Get Started with RabbitMQ on Docker
• MQTT Plugin Docs