Zigbee2MQTT 2.14: cubiertas invertidas tras actualizar y cómo arreglarlo
Última revisión: 12/09/2026
Si después de actualizar a Zigbee2MQTT 2.14.0 tu persiana, toldo o puerta de garaje aparece abierta cuando está cerrada, no has tocado nada mal: es un bug de la 2.14.0. El hotfix 2.14.1 lo corrige. Actualizar resuelve el estado en la mayoría de redes; si tu dispositivo ya venía invertido de antes, el arreglo está en la configuración del device, no en la actualización.
El bug en corto
| Versión | Fecha | Qué cambió |
|---|---|---|
| 2.14.0 | 1 sept 2026 | Introdujo varios cambios de configuración y dejó estados de cubiertas invertidos en varios dispositivos. |
| 2.14.1 (hotfix) | 3 sept 2026 | Corrige los estados invertidos reportados en #33004, #33014 y #33010. |
Cómo saber si te afecta
La señal es inconfundible: en Home Assistant la cubierta aparece open mientras la persiana está bajada, o closed cuando está subida. Los botones también se invierten: pulsas subir y baja, o al revés. El problema no viene de la red Zigbee ni de la integración con Home Assistant: es el estado que Zigbee2MQTT publica tras interpretar mal el device.
En el hilo 579062 de Home Assistant Community ya se rastreaba este cruzado con dispositivos Tuya en 2023. La diferencia es que entonces la causa estaba en la configuración de ciertos devices; la regresión de 2.14.0 es del propio Zigbee2MQTT y por eso se arregla simplemente actualizando.
Arreglo directo: actualizar a 2.14.1
- En Home Assistant, abre Ajustes → Sistema → Supervisor → Zigbee2MQTT.
- Comprueba que el addon está en la versión 2.14.1 o superior.
- Si sigue en 2.14.0, pulsa Actualizar y espera a que reinicie el servicio.
- Vuelve a la entidad de la persiana y conmuta abrir/cerrar una vez. El estado debe volver a coincidir con la posición real.
Si usas Docker, basta con cambiar la imagen a una etiqueta posterior a 2.14.1 y reemplazar el contenedor. No hay que volver a emparejar ningún dispositivo ni tocar la base de datos.
Si tu cubierta ya venía invertida antes de 2.14
Hay un caso distinto: dispositivos que ya pintaban el estado al revés antes de tocar 2.14.0. La comunidad lleva años llamándolo ajuste invert_cover por dispositivo, pero la referencia que tengo es de 2023 y no la doy por vigente con la interfaz actual. No publico YAML de inversión hasta verificarlo: si tu persiana ya fallaba antes de esta actualización, mira la pestaña de opciones del device en Zigbee2MQTT. Sin confirmar a fecha de 12/09/2026; lo validaré en una segunda parte cuando tenga la documentación actual delante.
Qué más trae 2.14.1
Además del arreglo de cubiertas, el hotfix añade la clase de estado para formaldehído en la integración con Home Assistant (#33006). Nada más relevante para tu red: es un parche quirúrgico, no un salto de versión.
Cambios de 2.14.0 que precedieron al bug
Por contexto, 2.14.0 traía dos cosas que querrás conocer si venías de 2.13: la opción de preservar la configuración del device al borrarlo (#32765) y soporte para offline_action e inverted en el POK001 de PushOk (#13062). El bug de cubiertas se coló en ese lote y por eso el hotfix llegó solo dos días después.
Nota de proceso
Verificado contra las release notes oficiales de Zigbee2MQTT y el tique de corrección. El ajuste invert_cover no está confirmado con la documentación actual, así que está marcado arriba como pendiente. No hay afirmaciones de salud ni dinero en esta pieza: es un cambio de software doméstico.
Primera publicación: 12/09/2026 — sin revisiones posteriores.