Basic question : Safe to upgrade directly from 1.42.0-2 to 2.4.0-1?

[dbm87]

Hi!
I'm running Home Assistant 2025.6.3 with Zigbee2MQTT 1.42.0-2. I stopped upgrading Zigbee2MQTT just before the 2.0 release. Now it's time to upgrade and the actual version is 2.4.0-1 and I don't know if I can upgrade directly to this version or it is necessary to upgrade fist to an intermediary version. I've searched the net without result. Can I upgrade safely from 1.42.0-2 to 2.4.0-1? If I must upgrade first to a lower version or if I must manually modify any config, can you point me to a How-to or any doc describing the steps? TIA

[Nerivec]

Note: July release is just around the corner (new release every 1st of the month).

The settings migration system introduced in 2.0.0 should take care of cycling through the necessary changes all the way to the current version. With each step a backup of your configuration.yaml will be made. More details: https://www.zigbee2mqtt.io/guide/configuration/configuration-update.html

Important

Make sure to go over the 2.0.0 breaking changes. Pay extra attention to the Home Assistant section, since you use it. And of course, always make a full backup of your system before starting an upgrade, just in case. 😉

For changes since 2.0.0, you can check the release notes here: https://github.com/Koenkk/zigbee2mqtt/releases

[dbm87]

Thank you very much for your answer!

Best regards
David