Cómo Instalar Zigbee2MQTT en Home Assistant: Guía (con Sonoff Dongle P)
Aprende a instalar Zigbee2MQTT en Home Assistant paso a paso utilizando el Sonoff Dongle P, configurando Mosquitto Broker, emparejando dispositivos y obteniendo máxima compatibilidad Zigbee.
Antes de esta lección, te recomiendo ver:
Si ya tienes tu coordinador Zigbee y has empezado a jugar con ZHA, es muy probable que hayas oído hablar de Zigbee2MQTT. ¿Por qué tantos usuarios avanzados prefieren esta opción? La respuesta es sencilla: compatibilidad total y control absoluto.
Zigbee2MQTT soporta miles de dispositivos y te permite ver detalles técnicos que otras integraciones ocultan. En este artículo, aprenderás a instalarlo paso a paso, ya sea que uses Home Assistant en una máquina virtual (como VirtualBox) o de forma nativa.
1. Requisitos Previos: El Hardware
Para que esta instalación sea un éxito, necesitas un buen "puente" entre tus dispositivos y tu servidor.
- Coordinador Recomendado: El Sonoff Dongle P es el estándar de la industria por su estabilidad.
- Servidor MQTT: Recuerda que, como vimos en el este capítulo, necesitas tener instalado y configurado Mosquitto Broker antes de empezar con Zigbee2MQTT.
2. Instalación en Home Assistant
El proceso se realiza a través de los Add-ons (Complementos):
- Ve a Ajustes > Complementos > Tienda de complementos.
- Añade el repositorio oficial de Zigbee2MQTT:
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt. - Instala el complemento llamado Zigbee2MQTT.
Configuración del puerto (¡Paso Crítico!)
Si usas VirtualBox, asegúrate de haber mapeado el puerto USB del Sonoff Dongle a la máquina virtual. En la pestaña de Configuración del complemento, deberás indicar la ruta de tu dispositivo (normalmente algo como /dev/ttyUSB0).
3. Emparejando tus primeros dispositivos
Una vez que el servicio esté iniciado, entra en la "Web UI" de Zigbee2MQTT:
- Haz clic en "Permitir unirse" (Permit join).
- Pon tu sensor o relé en modo emparejamiento (normalmente dejando pulsado el botón de reset unos segundos).
- ¡Magia! Verás aparecer el dispositivo con su nombre técnico, imagen y todos sus atributos disponibles.
Dispositivos ideales para empezar:
4. Integración con Home Assistant
Lo mejor de Zigbee2MQTT es que, gracias al protocolo MQTT que configuramos previamente, los dispositivos aparecerán automáticamente en tu panel de Home Assistant. No tienes que hacer nada más; estarán listos para ser usados en tus automatizaciones más complejas.
Conclusión: Libertad Domótica
Instalar Zigbee2MQTT puede parecer un paso un poco más técnico, pero la recompensa es una red robusta, rápida y compatible con casi cualquier sensor que compres en el futuro. Es la diferencia entre tener gadgets conectados y tener una verdadera Casa Inteligente.
Recursos de ayuda:
- Drivers y Firmware: Guía oficial de Sonoff
- Video Tutorial Paso a Paso: Ver en YouTube
- Cupones de Ahorro: Página de cupones actualizados
¿Has tenido problemas detectando el puerto USB en Windows o VirtualBox? ¡No olvides suscribirte al canal de HectorziN para no perderte el próximo tutorial sobre automatizaciones avanzadas!
Continúa aprendiendo

Cómo Instalar Mosquitto Broker y Dominar el protocolo MQTT
Instalamos Mosquitto Broker en Home Assistant y explicamos de forma sencilla qué es MQTT, para qué sirve y por qué es la base de muchas integraciones domóticas como Zigbee2MQTT.

Introducción a Zigbee, Coordinadores y Sensores
Descubre qué es Zigbee, cómo funcionan sus redes malladas, qué coordinador elegir para Home Assistant y cuáles son los sensores y dispositivos esenciales para empezar tu domótica local de forma estable y eficiente.

Instalación de Home Assistant en PC Windows 11 o 10 con VirtualBOX
Instala Home Assistant en Windows paso a paso usando VirtualBox y deja tu sistema listo para empezar a domotizar.
Fin de la lección
Volver al módulo Instalación