// the take
This is the official Home Assistant Supervisor add-on wrapper for Zigbee2MQTT — it packages the actual Zigbee2MQTT project (a separate repo by Koenkk) into an installable add-on with a config UI, so Home Assistant OS/Supervisor users get Zigbee2MQTT without running a standalone Docker setup. It's for HA users who want Zigbee2MQTT specifically over the built-in ZHA integration.
Offers three distinct variants in one repo — stable, an Edge build tracking Zigbee2MQTT's dev branch, and a reverse-proxy add-on — so you can ride the bleeding edge without forking anything. The onboarding UI auto-detects the USB adapter and writes the serial config for you, sparing most users from hand-editing YAML. CI/release workflows build and publish on every tag, and the project stays tightly coupled to upstream Zigbee2MQTT releases so version drift isn't an issue.
It's a thin packaging layer, not the application itself — any functional Zigbee issue gets redirected to the upstream Koenkk/zigbee2mqtt tracker, so this repo's own issue history tells you little about reliability. Migrating from a standalone install is a fully manual process requiring SSH into HA OS and scp'ing data folders around, with no automated backup/restore path. The README flags Raspberry Pi 3 as unstable due to resource limits, which cuts out a meaningful slice of existing HA hardware. Debugging a stuck add-on means shelling into the container directly and disabling the Supervisor's Watchdog, which is a rough experience for anyone not already comfortable with Docker internals.
We read the README, the directory tree and a key source file in October 2026. Nobody pays to be listed. How we judge →