Zigbee2MQTT vs ZHA en 2026: cuál elegir según tu red
Zigbee2MQTT y ZHA hacen lo mismo a efectos prácticos, controlar dispositivos Zigbee desde Home Assistant, pero son arquitecturas distintas. Uno se apoya en MQTT y Mosquitto; el otro es la integración nativa que ya trae HA. La elección depende de cuánto quieras afinar y cuánto debug estés dispuesto a abrazar.
Las tripas de cada uno
Zigbee2MQTT es un servicio aparte. Habla con el coordinador Zigbee por un lado y con un broker MQTT por el otro. Home Assistant se entera de todo vía la integración MQTT. El bloque mínimo de configuración de Z2M es este:
mqtt:
server: mqtt://core-mosquitto:1883
user: mqtt-user
password: mqtt-pass
serial:
port: /dev/serial/by-id/usb-XXXXZHA, en cambio, no requiere nada de eso. Se instala como integración dentro de HA, escoge el coordinador y empieza a descubrir dispositivos. Menos piezas, menos sitios donde algo se tuerce, y también menos alcance para mirar qué está pasando cuando algo no funciona.
En qué gana cada uno
| Dimensión | Zigbee2MQTT | ZHA |
|---|---|---|
| Arquitectura | Servicio separado + Mosquitto + integración MQTT | Integración nativa de HA |
| Soporte de dispositivos | Más amplio, mantenido por conversores comunitarios | Bueno en hardware habitual, limitado a lo que libera cada release de HA |
| Depuración | Logs por dispositivo, temas MQTT inspeccionables por separado | Todo centralizado en HA; menos herramientas para mirar la conversación Zigbee |
| Versionado | Independiente; la estable actual es 2.14.1 (septiembre 2026) | Sigue el ciclo mensual de Home Assistant (2026.9.x) |
| Curva de entrada | Más alta: otro contenedor, otro servicio, una capa más | Baja: integración y a escanear |
No doy cifra de dispositivos soportados: cambia con cada release y un número publicado hoy quedaría obsoleto enseguida. El punto que de verdad diferencia a Zigbee2MQTT es la conversación MQTT inspeccionable: puedes ver exactamente qué publica un dispositivo raro y escribir un convertir a medida. Con ZHA, si algo no está soportado, esperas al release de HA que lo añada.
La lección del bug de cubiertas 2.14.0
Sirve como ejemplo real de por qué conviene entender el modelo de versionado: Zigbee2MQTT 2.14.0 (2026-09-01) rompió el estado de cubiertas en varios dispositivos; el hotfix 2.14.1 salió dos días después. Ese ciclo corto se debe a que Z2M se releasea aparte. ZHA, al ir empaquetado con HA, suele esperar al siguiente ciclo mensual para lo no urgente. Ninguno de los dos es mejor por esto; es información para decidir con cuánto te molesta tocar una actualización y con cuánto toleras esperar un parche.
Última revisión: 13/09. Cambios: meta description recortada de 168 a rango, JSON-LD Article añadido, versiones estables actualizadas (Z2M 2.14.1 y HA 2026.9.x) y nota sobre el bug de cubiertas 2.14.0 corregido en 2.14.1.