Textbook of Linux

← Software

Eclipse Mosquitto

A lightweight MQTT broker.

Eclipse Mosquitto implements the MQTT protocol that has become the dominant publish/subscribe protocol for IoT and home- automation systems. The server is small enough to run on constrained hardware (Raspberry Pi or smaller), supports MQTT 3.1, 3.1.1, and 5.0, and includes both TLS-encrypted MQTT and WebSocket transports out of the box.

Roger Light started Mosquitto in 2009 and the project moved to the Eclipse Foundation in 2014. It is the broker behind Home Assistant's default MQTT integration, AWS IoT Greengrass's local broker, and many industrial-IoT and smart-home gateways. Companion clients (mosquitto_pub, mosquitto_sub) make it easy to script publishing and subscription from shell scripts.

For larger MQTT deployments — millions of devices, brokered sharding — companies tend to graduate to commercial brokers like HiveMQ or EMQX, but Mosquitto remains the default choice for home and small-to-medium industrial setups, and its ubiquity in documentation and tutorials makes it the easy starting point for anyone getting into MQTT.

Debian/Ubuntu: sudo apt install mosquitto mosquitto-clients
Fedora/RHEL:   sudo dnf install mosquitto
Arch:          sudo pacman -S mosquitto
macOS:         brew install mosquitto