How to back up and restore Zigbee network

Backups are a critical part of any local-first smart home setup, especially when working with Zigbee devices. Zigbee networks are inherently fragile — a single node failure, a firmware update gone wrong, or a misconfiguration can leave your entire network in disarray. For Home Assistant users, the ability to restore a Zigbee network is not just a convenience, but a necessity. This guide will walk you through the practical steps to back up and restore your Zigbee network, with specific advice for Home Assistant, HomeKit, and Hubitat.

Why Backing Up Your Zigbee Network Matters

Zigbee networks are decentralized, meaning they rely on a coordinator (like a Zigbee hub or a Home Assistant instance) to manage communication between devices. If that coordinator fails or gets reconfigured, you risk losing all your device data, including device IDs, network keys, and device-specific settings.

In a Home Assistant setup, the coordinator is typically a Zigbee USB dongle (like the ConBee III or the Sonoff Zigbee 3.0 USB Dongle Plus) or a dedicated hub like the Aqara Hub M3 or the Aeotec Smart Home Hub. These devices store the network information, and without a backup, you could lose access to your entire Zigbee ecosystem.

The stakes are even higher if you’re using a hub like the Aeotec Smart Home Hub or the Hubitat Elevation C8. These hubs often have more complex configurations, including device groups, scenes, and advanced automation. Losing that data can be a nightmare to recover.

How to Back Up Your Zigbee Network

1. Use the Right Tools for Your Coordinator

The first step in backing up your Zigbee network is to identify the type of coordinator you’re using. Each coordinator has its own method for exporting or backing up the network. For Home Assistant, the zigbee2mqtt integration or the deCONZ integration (if using a ConBee II or III) will handle the backup process.

For example, if you’re using the ConBee III or Sonoff Zigbee 3.0 USB Dongle Plus, you can use the deCONZ integration to export the network. This will generate a JSON file containing all your device information, including device IDs, network keys, and device-specific settings.

If you’re using a Home Assistant Green or Home Assistant Yellow, you can use the built-in zigbee2mqtt integration to back up your network. This integration allows you to export the entire Zigbee network state, which can be used to restore your network if needed.

For Hubitat Elevation C8 users, the backup process is slightly different. You can use the Hubitat web interface to export your network configuration, which includes device groups, scenes, and automation rules. This backup is crucial if you’re planning to migrate to a new hub or if you want to ensure your network is recoverable in case of a hardware failure.

2. Store Backups in a Secure Location

Once you’ve exported your network, it’s important to store the backup in a secure, offsite location. Cloud storage services like Google Drive, Dropbox, or even a local NAS can be used, but make sure to enable encryption if you’re storing sensitive data.

For Home Assistant users, it’s also a good idea to keep a backup of your configuration files. If your Home Assistant instance is ever reinstalled or moved, having a backup of your Zigbee network data can save you hours of reconfiguration.

If you’re using a Hubitat Elevation C8, consider using a USB drive or an external hard drive to store your backup. This ensures that even if your cloud storage is compromised, you still have a local copy of your network data.

How to Restore Your Zigbee Network

1. Reinstall Your Coordinator and Reconfigure

Restoring a Zigbee network is often a matter of reinitializing your coordinator and rejoining your devices. If you’re using a ConBee III, you’ll need to reset the coordinator and then rejoin your devices using the deCONZ integration in Home Assistant.

For Home Assistant Green or Yellow, the process is similar. You’ll need to reset the Zigbee dongle and then use the zigbee2mqtt integration to rejoin your devices. This will restore your network configuration and ensure that all your devices are back online.

If you’re using a Hubitat Elevation C8, you’ll need to import your backup file through the web interface. This will restore your device groups, scenes, and automation rules. However, you’ll still need to rejoin your devices to the network, which can be time-consuming.

2. Rejoin Devices and Reconfigure

After restoring your backup, you’ll need to rejoin your Zigbee devices to the network. This is often done by placing the devices in pairing mode and then using the coordinator to rejoin them.

For example, if you’re using a Philips Hue Bridge or an Aqara Hub M3, you can place your Zigbee devices in pairing mode and then use the hub to rejoin them. This process can take several minutes, depending on the number of devices and the stability of your network.

In some cases, you may need to manually reconfigure certain devices, especially if they have specific settings or integrations. For example, if you’re using a SwitchBot Hub 2 or a SwitchBot Hub Mini Matter, you’ll need to ensure that all your devices are properly paired and that their settings are restored.

Tradeoffs and Real-World Considerations

Backups are not foolproof. If your Zigbee network is compromised by a firmware update or a hardware failure, you may still lose data. For example, if you’re using a Sonoff Zigbee 3.0 USB Dongle Plus, a firmware update could potentially corrupt your network data, even if you have a backup.

Another consideration is the complexity of the backup itself. A backup file for a Hubitat Elevation C8 includes more than just device data — it also includes automation rules, device groups, and scene settings. This means that restoring a backup is not just about rejoining devices, but also about reconfiguring your entire network.

In contrast, a backup from a Home Assistant Green or Yellow is more focused on device data and network state. This makes it easier to restore, but it may not include all the automation or integration details you had before.

Quick Verdict

Backups are essential for any Zigbee network, especially in a local-first smart home setup. Whether you’re using Home Assistant, HomeKit, or Hubitat, the process involves exporting your network data, storing it securely, and then rejoining your devices when needed. While the process can be time-consuming, it’s worth the effort to avoid the headache of rebuilding your entire network from scratch. Always keep your backups up to date and stored in a secure location — your smart home will thank you.