Zigbee2MQTT y ZHA se pelean por el mismo dongle Sonoff
Tras reiniciar la Raspberry, los dispositivos Zigbee dejan de responder y ZHA muestra el error «network settings don't match backup».
Por qué pasa (diagnóstico)
- Zigbee2MQTT (contenedor con restart=always/unless-stopped) arranca antes que ZHA y toma el dongle; los dos escriben configuración distinta en el coordinador.
- El backup de red de ZHA ya no coincide con lo que hay en el dongle.
- Puerto serie /dev/ttyUSB* compartido por dos integraciones.
Solución paso a paso
- Decide qué stack usas (en este caso ZHA) y para el otro:
docker stop zigbee2mqtt. - Evita que vuelva al reiniciar:
docker update --restart=no zigbee2mqtt. - En Home Assistant, reconfigura ZHA y elige restaurar el backup automático de red de ZHA.
- Reinicia la integración ZHA y comprueba que los dispositivos vuelven a reportar.
Requisitos
- Dongle Zigbee Sonoff (ZBDongle-P/E)
- Raspberry Pi o servidor
- Home Assistant con ZHA
- Docker
Compatibilidad
- Home Assistant Container 2026.x
- Sonoff ZBDongle
Verificación
Probado en un servidor doméstico real con Raspberry Pi 5: tras restaurar el backup los dispositivos volvieron a funcionar y el reinicio ya no reproduce el fallo.
Fuentes
- Home Assistant — Integración ZHA (en inglés)
- Docker — docker update (en inglés)
Para saber más
- Para saber más: Domótica Compatible (podcast) · Zigbee2MQTT Nunca mais! (04/04/2025). Un error de configuración en Zigbee2MQTT y la migración a ZHA.
Manuales de aparatos relacionados
- Sonoff ZBDongle-P
- Sonoff ZBDongle-E
- SMLIGHT SLZB-06
- Home Assistant Yellow
- Home Assistant Connect ZBT-1 (antes SkyConnect)
Guías relacionadas
- Dispositivos Zigbee que se caen: interferencias del coordinador USB
- Un dispositivo Matter no se empareja en Home Assistant
- Un dispositivo Matter deja de responder en Home Assistant
- Zigbee2MQTT: el dispositivo no se empareja
- Sensor Zigbee no disponible tras cambiar la pila
- ZHA: red Zigbee inestable, cambiar de canal
Más guías de Home Assistant.