Is Zigbee2MQTT 2.14.3 safe to update?

Yes, with care. No explicit breaking changes, but the notes mention migrations, deprecations or a new release line. Back up first.

What users are reporting

16 public report(s) mention this version, none clearly describing breakage. Most-discussed: “[External Converter]: TS030F from _TZ3210_nz9dycbh”. Sources: GitHub · checked 2026-11-02

• [External Converter]: TS030F from _TZ3210_nz9dycbh (GitHub)
• Danfoss Ally eTRV0103 fails to write danfossHeatingSystemMode with INVALID_DATA_TYPE (GitHub)
• HOBEIAN ZG-IR01: HA infrared receiver template fails ("LoggingUndefined is not JSON serializable") when learned_ir_timings is absent from pa (GitHub)
• Sonoff TRVZB: Missing Attribute (GitHub)
• Tuya TS0501B LED Strip dimmer - joins, interviews then drops off network 20 seconds later & won't stay connected (Telink Chipset with Ember (GitHub, closed)

Reports are from public issue trackers and forums. Their count isn't a failure rate, and an empty list doesn't prove an update is safe.

⚠️ What breaks

Nothing explicitly breaking is flagged, but the notes mention migrations, deprecations or larger changes. Most setups upgrade fine. Back up first and update when you have time to check.

From the release notes

• Deprecation of 32-bit platforms:** Running Zigbee2MQTT on 32-bit platforms is deprecated, and support ends when Node.js 22 reaches end-of-life (April 2027). At that point the minimum supported Node.js version becomes v24, and Node.js v24 no
• [#33412](https://github.com/Koenkk/zigbee2mqtt/issues/33412) Home Assistant: log deprecation message when exposing switch as light (@cristianchiriac)
• [#33508](https://github.com/Koenkk/zigbee2mqtt/issues/33508) Home Assistant: note legacy_action_sensor is deprecated (@andrei-lazarov)

Read the full official release notes →

✅ What to do first

1. Read the official release notes (linked in “What breaks”).
2. Back up config and data (snapshot the VM/volume if you can).
3. Note the version you are on now, so you can roll back.
4. Update, then check logs and core functions before walking away.

↩️ How to roll back to 2.14.2

Docker: snapshot/back up the data volumes first, then if needed change the tag back, e.g. image: koenkk/zigbee2mqtt:2.14.2, and run docker compose up -d. Tag format varies by image (some drop the “v”), so check the registry’s tag list.