ZHA libraries will soon support ConBee/RaspBee backup and restore that can be used for Zigbee network migrations

zigpy developers are apparently working on deconz backup and draft pull request can be found here:


Part of that larger PR include: “Initial implementation of cross-adapter network backup/restore”.

So that means that users of ZHA with ConBee or RaspBee can soon do backup and migrations too.

At least that is how I interpret answer from puddly when posted this feature request for zigpy-deconz:


Request for developers who own ConBee or RaspBee (deCONZ based adapters) and are depending on zigpy-deconz to consider implementing Zigbee network backup and restore tools to zigpy-deconz (or zigpy-cli) supporting “Open ZigBee Coordinator Backup Format” as already supported by both zigpy-znp and bellows radio libraries:

FYI, this open format is already used as a migration method for other types of adapters as seen here:

Note! Please understand that zigpy and the zigpy-deconz radio libraries which ZHA depends on are all free and open-source library with only volunteering developers working on them without pay so remember and you and anyone else are also are more than welcome to code the feature for it (the zigpy developers have so far been more than happy to help and other volenteering developers who are willing to step in to assist with helping to fix bugs or add features).

PS: This Open ZigBee Coordinator Backup Format is also used by the Zigbee2MQTT (Z2M) project.

PPS: This open backup format is not supported by dresden elektronik’s official Phoscon Software.

PPPS: Until this happens will need to backup ConBee and RaspBee NVRAM with Phoscon/deCONZ:




I’m considering moving from ZHA to Z2M and from a Conbee II to a Sonoff Zigbee 3.0 coordinator. This initiative sounds like it would lessen my workload considerably! Big yay!

FYI, testers testing it has now confirmed that patches for the mentioned pull request work with ConBee:


PS: Consider voting for related feature request → ZHA integration to do nightly backup of both Zigbee Coordinator adapter/dongle/stick and Zigbee database?


Is it possible now to move from CC2531 to Conbee II or Raspbee ? 2022.07 is released now, but i cant find informations about backup&restore.

It is possible but currently, you still have to do the backup and restore via zigpy / zigpy-cli, again see → https://github.com/zigpy/zigpy-cli/pull/2

But keep an eye on ZHA integration to do nightly backup of both Zigbee Coordinator adapter/dongle/stick and Zigbee network/database?

Have you done it already. I am in the same situation. Will get my Sonoff Zigbee 3.0 Dongle tomorrow.

Went with the SkyConnect instead. :blush:

Ok, thanks. But did you re-pair every device you have? That is my trouble - have one device which I can’t reach without unmounting the furniture.

Yes, unfortunately I did it the manual way.

But I found this guide, that might be of help:

Home Assistant SkyConnect (home-assistant.io)

FYI; they posted some guides for migrating Zigbee devices from deCONZ/Phoscon or Zigbee2MQTT:

Again, migration from deCONZ/Phoscon or Zigbee2MQTT is not seamless, as it will only migrate the Zigbee network, (that way you at least do not need to run around and re-pair/re-join all your devices), unfortunately, it does not migrate the entries in Home Assistant so still need to rename those devices and update any automations and scripts that are using the old device names.

Note that if using a ConBee/RaspBee adapter then you first need to upgrade deconz firmware on it.

There is currently no migration path to migrate all settings, devices and entities to Home Assistant ZHA.

1 Like

Thank you for the information. I tried it but in my case it wasn’t very successfull. Migration from deconz to zha with the conbee II stick did work - but the network was very unstable. I tried to reconfigure the coordinator to the new sonoff stick - but this failed - the entities in ha where correct but they didn’t do anything.
So I reverted to the snapshot and leave it on my deconz for now.
If I get more time - I will try it again :wink:
Thanks for all the help.