Downgrade Zigbee2MQTT After a Bad Update: What’s Safe
Zigbee2MQTT update broke something? How to downgrade on Docker, the Home Assistant add-on or bare metal, what to back up first, and what can't roll back.
Setup guides
Zigbee2MQTT update broke something? How to downgrade on Docker, the Home Assistant add-on or bare metal, what to back up first, and what can't roll back.
Tuya device connects then drops in LocalTuya or tuya-local? How protocol 3.3, 3.4 and 3.5 differ, how to find yours, and what stays fully local.
Tuya device won't pair on your IoT VLAN? Why EZ mode fails, why AP mode helps, and why the segment needs internet while Smart Life pairs it.
Want a Tuya local key for LocalTuya or tuya-local without an IoT Platform account? Compare the routes that skip it and what each still sends to the cloud.

Zigbee2MQTT pinging a long-gone device every 12 seconds? A setTimeout overflow in the availability backoff. How 2.14.0 fixes it, and a workaround.

OTA checks failing on several unrelated Zigbee2MQTT devices at once? One misbehaving device can hijack OTA server discovery. How to spot and remove it.

Zigbee2MQTT won't start with ASH_ERROR_TIMEOUTS after a Node.js update? The cause is a serialport bug on Node 26.3+, and Zigbee2MQTT 2.14.0 patched it.

Zigbee2MQTT's remove request just gained keep_config and clear_cache. What each preserves before you re-pair a device, and what neither one touches.

Diagnose Zigbee2MQTT onboarding loops, hangs and 404 errors using startup logs, saved settings, data paths and version-specific fixes.

Set up supported Tuya TS0203 variants in Zigbee2MQTT, identify the manufacturer string, check the documented false-contact fix and test battery reports.