Si estás buscando una forma robusta, profesional y universal de gestionar tus dispositivos domóticos, instalar Zigbee2MQTT en Home Assistant es la mejor decisión que puedes tomar. A diferencia de otras integraciones, Zigbee2MQTT ofrece compatibilidad con miles de dispositivos y un control total sobre tu red sin depender de la nube.
En esta guía actualizada a diciembre de 2025, vamos a ver desde la elección del hardware hasta la configuración avanzada para que tu red Zigbee sea infalible.
¿Por qué elegir Zigbee2MQTT frente a ZHA?
Esta es la eterna duda. Mientras que ZHA (Zigbee Home Automation) es sencillo y nativo, Zigbee2MQTT es mucho más potente.
- Compatibilidad: Soporta dispositivos que a veces fallan en ZHA.
- Independencia: Si reinicias Home Assistant, tu red Zigbee sigue funcionando en segundo plano.
- Flexibilidad: Permite usar herramientas externas como MQTT Explorer para depurar fallos.
Tip para expertos: Si eres de los que no quiere renunciar a nada, he desarrollado un método único paraintegrar Zigbee2MQTT y ZHA con un solo coordinador, algo que hasta hace poco parecía imposible.
El Hardware: El cerebro de tu red
Para que Zigbee2MQTT funcione, necesitas un «coordinador». En 2026, estas son las mejores opciones:
- Sonoff Dongle-P: El clásico USB que nunca falla.
- SMLIGHT SLZB-06: La revolución actual. Al ser un coordinador Zigbee Ethernet, puedes colocarlo en el centro de tu casa conectado por cable de red, mejorando drásticamente la cobertura. Puedes ver mi análisis a fondo del SLZB-06 aquí.
Material utilizado en este vídeo
Paso 1: Instalación de Mosquitto Broker
Zigbee2MQTT necesita un «traductor» para hablar con Home Assistant, y ese es el protocolo MQTT.
- Ve a Ajustes > Complementos > Tienda de complementos.
- Busca e instala Mosquitto Broker.
- En la pestaña «Configuración», asegúrate de crear un usuario específico para MQTT en Home Assistant (Ajustes > Personas > Usuarios).
- Inicia el servicio y activa la opción de «Vigilancia».
Paso 2: Instalación de Zigbee2MQTT
Para instalar el Add-on oficial, sigue estos pasos:
- En la Tienda de complementos, haz clic en los tres puntos (arriba a la derecha) y selecciona Repositorios.
- Añade la URL oficial:
https://github.com/zigbee2mqtt/hassio-addon. - Busca Zigbee2MQTT en la lista e instálalo. No lo inicies todavía, primero debemos configurarlo.
Paso 3: Configuración del puerto y adaptador
Este es el punto donde la mayoría falla. Debes decirle al sistema dónde está pinchado tu USB o cuál es la IP de tu coordinador.
Ve a la pestaña Configuración del Add-on y rellena el apartado serial:
YAML
socat:
enabled: false
serial:
port: >-
/dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_v2_...
Si usas un SLZB-06 por red, el puerto será algo como tcp://192.168.1.50:6638.
Configuración MQTT
Asegúrate de que el bloque MQTT tenga los datos del usuario que creaste:
YAML
mqtt:
base_topic: zigbee2mqtt
server: mqtt://core-mosquitto:1883
user: tu_usuario_mqtt
password: tu_password_mqtt
Paso 4: Emparejar dispositivos
Una vez configurado, inicia el Add-on y abre la Interfaz de usuario web.
- Haz clic en «Permitir unirse (All)».
- Pon tu dispositivo (bombilla, sensor, enchufe) en modo emparejamiento.
- ¡Listo! Aparecerá automáticamente en tu panel de Home Assistant.
Solución de errores comunes (FAQ)
Suele ocurrir porque el Add-on aún se está iniciando o hay un error en el puerto serial. Revisa el Log.
Si tus dispositivos se desconectan, cambia el canal Zigbee (el 25 es el más limpio en 2026) para que no choque con tu WiFi de 2.4GHz.
Tutorial en Vídeo
Para ver todo este proceso en acción y no perderte ningún detalle visual, te recomiendo ver mi vídeo tutorial completo:
¿Te ha servido esta guía? Si tienes dudas sobre qué coordinador elegir o cómo migrar desde ZHA, déjamelo en los comentarios. ¡Nos vemos en el próximo nivel de tu hogar inteligente!
Sígueme a YouTube
