Zigbee2MQTT OTA Update Failed or Stuck? How to Fix It
A Zigbee2MQTT OTA that errors out or freezes at a percentage is rarely a bricked device. Here's what each failure means and which fix actually applies.
~/archive $ ls -la
Archive
Setup Guides
Setup guides
-
-
ZHA to Zigbee2MQTT Migration: Re-Pair or Convert DB
Migrating from ZHA to Zigbee2MQTT: the reliable re-pair method, the two-part no-re-pair shortcut, and how to sequence it without losing your mesh. Stays local.
-
Zigbee2MQTT \”Failed to Interview\”: Why Pairing Gets Stuck
A Zigbee2MQTT pairing that stalls on \"failed to interview\" usually means the join worked and the discovery queries timed out — not a config mistake.
-
Writing a Custom ZHA Quirk for an Unsupported Zigbee Device
Your Zigbee device pairs with ZHA but exposes only generic entities. How to enable custom quirks and write one with QuirkBuilder, entirely locally.
-
Zigbee2MQTT \”Failed to Configure\” Error: What It Means
Zigbee2MQTT's \"Failed to configure\" error explained: what the ZCL status codes mean, when it's harmless, and how to force a reconfigure without re-pairing.
-
Zigbee2MQTT: Remove vs Force Remove vs Factory Reset
Zigbee2MQTT's Remove, Force Remove, and a physical factory reset do three different things to a device's network key. The mechanism, and which one to use before you sell or bin hardware.
-
Zigbee2MQTT Touchlink: Reset Devices Before Pairing
Secondhand Hue or IKEA Zigbee bulbs won't join Zigbee2MQTT until factory-reset. Here's how Touchlink does that over MQTT, and which devices it works on.
-
Tuya TS0043 3-Button Scene Switch: Zigbee2MQTT + Home Assistant Setup
The Tuya TS0043 3-button switch also ships as LoraTap SS600ZB and Lonsonho TS0043. Pairing, entities, and automations in Zigbee2MQTT or ZHA — fully local.
-
Should You Update Your Zigbee2MQTT Coordinator Firmware?
Your Zigbee2MQTT coordinator flags outdated firmware. Here's when updating is worth it, how to back up first, and the right tool per adapter.
-
Migrating a Tuya Zigbee Gateway to Zigbee2MQTT
There's no in-place transfer from a Tuya Zigbee gateway to Zigbee2MQTT. Here's the reset-and-rejoin process, and what breaks in Home Assistant.