Saltar a contenido

Source: ZHA vs Zigbee2MQTT (ordoh.com 2026)

Comparativa accionable de las dos opciones para correr Zigbee en HA. Verdict del autor: ZHA si <20 devices y simplicidad importa; Z2M si 50+ devices, ecosistema mixto (Tuya/Sonoff/IKEA/Aqara), o querés diagnostics detallados.

Por qué entró al wiki

  • Pregunta guía Q9 directa: stack Zigbee para el setup actual del usuario.
  • El usuario hoy corre Z2M (asumido por contexto, default del HA Yellow setup); esta page le ayuda a evaluar si conviene quedarse o cambiar a ZHA.

Páginas derivadas

Datos clave

Device support 2026

  • Z2M: 3,400+ devices.
  • ZHA: ~2,000 devices.
  • Gap evidente: budget Tuya sensors, Sonoff nuevos, Chinese OEM sin certification formal.

Setup

  • ZHA: 3 pasos, sin broker externo.
  • Z2M: 8 pasos, requiere Mosquitto.

Reliability bajo fallos

  • ZHA: sin dependency de broker externo, restart limpio dentro de HA, soporte del HA core team.
  • Z2M: dependency de Mosquitto (broker crash = network down), updates community-driven (más frecuentes, más rotura potencial), restarts coordinados.

Migración

  • ZHA ↔ Z2M: re-pair de cada device desde cero. Sin tool automático. ~30 min mínimo para red mediana.

Hardware

  • Mismo coordinator funciona en ambos (SONOFF Dongle, SkyConnect, ZBT-1). No hay que cambiar hardware.

Upgrade behavior con HA Core

  • ZHA: upgrades coordinadas con HA core. Backward compat más estable.
  • Z2M: updates independientes, ocasional version mismatch con Mosquitto, YAML breaking changes — requiere manual testing.

Citas textuales

  • "Migrating from ZHA to Zigbee2MQTT requires you to re-pair every Zigbee device from scratch."

  • "Either coordinator works with both ZHA and Zigbee2MQTT, so you do not need to buy different hardware."

  • ZHA flexibility: "more technically demanding to write and submit" custom device support vs Z2M "more accessible".

Implicancia para el setup del usuario

Si el usuario tiene ~20-50 devices Zigbee con marcas mainstream (Aqara, IKEA, Philips, Sonoff), está en el medio del verdict. Recomendación pragmática dada la meta "no tinkering":

  • Quedarse en Z2M si ya está funcionando (que parece ser el caso). Razón: el costo de migración es altísimo (re-pair todo) y el upside de ZHA es solo "menos componentes que mantener". El usuario ya tiene Mosquitto integrado al stack de essentials/experimental.
  • Migrar a ZHA solo si Z2M está rompiéndose con cierta regularidad bajo HA upgrades, y la frecuencia del dolor justifica una sesión de re-pair masiva.

Ver ../comparisons/zha-vs-z2m-2026 para la matriz completa.

Abierto / gaps

  • Confirmar el setup actual del usuario: ¿Z2M o ZHA hoy? (asumido Z2M; pero el CLAUDE.md no lo confirma).
  • Validar el dato "3,400+ devices Z2M / 2,000 ZHA" contra el repo oficial de Z2M y la documentation de ZHA.
  • Ingerir un postmortem específico de Z2M-rompe-tras-HA-upgrade (gap catalog).