The maintained version now lives at MQTT (mosquitto) swarm template, part of scyto/homelab-docs — searchable, cross-linked, and easier to keep current.
This gist stays put so the comments below remain readable — there is a lot of useful troubleshooting in them. For corrections, please open a PR or issue on the repo.
This template runs mqtt for use with home automation
With the latest version of mosquitto a single config is required to enable it to listen. You can do this by mapping thevconfig in a volume mount as per normal. However in this version i have implemented configs as these are available to the whole swarm
none, this published default port of 1883 (if you need port 9001 then you already know why and how to modify this example :-) )
None, by default this template will result in a single replica. This is for home network so no addtioanl scale or redundancy needed in my usecase.
version: "3.8"
services:
mosquitto:
image: eclipse-mosquitto
configs:
- source: mqtt_config
target: /mosquitto/config/mosquitto.conf
ports:
- 1883:1883
configs:
mqtt_config:
external: true
the data store in the cofig looks like this :-) Use the portainer UI to create a config - note once created they cannot be edited (they have to be destroyed and recreated and configs in use by a stack cannot be deleted. As such best used for config data you don't want to change very often.
listener 1883
allow_anonymous true
I'm a big fan of EMQT. Did you ever try it ?