You can now back up your complete Zigbee2MQTT configuration

Disclosure: This post contains affiliate links. If you click through and make a purchase, I’ll earn a commission, at no additional cost to you. Read my full disclosure here.

Zigbee2MQTT 1.26.0 adds a neat feature for those conscious of the fact that things can and do sometimes go wrong. You can now create, and download, a complete backup of your Zigbee2MQTT configuration. This can be done using by publishing zigbee2mqtt/bridge/request/backup using MQTT, or via the frontend.

Within the downloaded backup, you will find four files:

  • You will find your configuration in the file configuration.yaml. This includes things such as the MQTT broker configuration, all the devices you have paired and their friendly names, and groups.
  • The configuration file is nothing without the coordinator. Every Zigbee device you have added to Zigbee2MQTT, is paired with a single coordinator. For that reason, there is also a backup of the coordinator in the file coordinator_backup.json.
  • Your database is backup up in the file database.db. The database contains all your individual devices, their, ID, address, and more.
  • Finally, the state.json file is the list interesting of the bunch. It includes the current state of the Zigbee devices controlled by Zigbee2MQTT. These states continually change, and the file will most likely be out-of-date by the time you download it.
Liam Alexander Colman, the author and maintainer of Home Assistant Guides.

About Liam Alexander Colman

Liam Alexander Colman has been using Home Assistant for various projects for quite some time. What started off with a Raspberry Pi quickly became three Raspberry Pis and eventually a full-blown server. I now use Unraid as my operating system, and Home Assistant happily runs in a Docker container. My personal setup includes many Zigbee devices as well as integrations with existing products such as my Android TV box. Read on to find out more on how I got started with Home Assistant.

Leave a comment

Share to...