Mosquitto
eclipse-mosquitto:2
https://hub.docker.com/r/library/eclipse-mosquitto
host
sh
false
https://github.com/47Hunter47/mosquitto-unraid-ca/issues
https://mosquitto.org/
https://raw.githubusercontent.com/47Hunter47/mosquitto-unraid-ca/main/icon.png
Official Eclipse Mosquitto 2.x image (continuously updated, last push 2026-06) with a minimal Unraid template: host networking and a single /config folder. Unlike cmccambridge/mosquitto-unraid (custom image frozen at 2.0.20 since 2024-11) or spants/mqtt (Mosquitto 1.x, unmaintained since 2020), this template always tracks the official upstream image. MQTT protocol 5, standard /config layout.
Official Eclipse Mosquitto 2.x image, pre-configured for Unraid.
Why this template:
- spants/mqtt is based on Mosquitto 1.x and has not been updated since 2020. Mosquitto 2.x writes a newer persistent database format (v6) that 1.x cannot read, so upgraded data folders break the old template.
- cmccambridge/mosquitto-unraid is a custom image that has not been rebuilt since 2024-11 (frozen at Mosquitto 2.0.20). This template uses the official eclipse-mosquitto image, which is continuously updated upstream.
- Modern Home Assistant requires MQTT protocol 5, which Mosquitto 2.x supports.
Configuration:
- mosquitto.conf, passwords.mqtt and data/ live in /config (host: /mnt/user/appdata/Mosquitto by default).
- Create users with: mosquitto_passwd -c -b /config/passwords.mqtt <user> <password>
- Enable auth in mosquitto.conf: allow_anonymous false + password_file /config/passwords.mqtt
- Host networking: broker listens on 1883 by default (set listener in mosquitto.conf).
HomeAutomation:MQTT
https://raw.githubusercontent.com/47Hunter47/mosquitto-unraid-ca/main/templates/mosquitto.xml
/usr/sbin/mosquitto -c /config/mosquitto.conf
host
/mnt/user/appdata/Mosquitto
/config
rw
Europe/Istanbul
TZ
/mnt/user/appdata/Mosquitto