highly available mosquitto brokers
Python Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Mosquitto HA

This project demonstrates how mosquitto brokers can be configured for high availability. Incoming messages and topics are replicated across broker nodes. This configuration does not scale horizontally, but provides redundancy.

Getting Started

all applications in this project are run in docker containers, so simply clone the project, then run docker-compose up

Cluster Structure

MQTT messages that are routed to any of the broker containers are forwarded to all other broker containers via one of the bridge nodes. The flow looks like this:

MQTT-Publisher -> Mosquitto-Broker -> Mosquitto-Bridge -> Other-Mosquitto-Brokers

the cluster structure looks like this:

Application Breakdown

this project has 3 notable containers:

Mosquitto Alpine (Bridge Node)

This is an alpine based image with mosquitto installed and some minor changes to the mosquitto.conf file. The docker-compose.yml file specifies two of these containers. the bridge container is the primary bridge. All messages are routed through this container unless the container dies or becomes unavailable. If the bridge container becomes unavailble, the hot-standby-bridge container becomes the main connection for all mosquitto brokers.

Mosquitto HA Broker

This image is based off of the Mosquitto Alpine image. It has added configuration that publishes any messages it receives from connected clients to the bridge container. It also subscribes to all topics on the bridge node, which means it gets all the messages from the other brokers in the cluster.

Mosquitto Publisher

This is a simple MQTT publisher used for testing purposes. It publishes MQTT messages to the specified broker on the specified port. It has a delay interval which is necessary to give the mosquitto cluster time to stand up.


  • Add functional subscriber


Fork and submit a pull request


  • Matt Rabinovitch


This project is licensed under the MIT License