Where Does deCONZ Store the Zigbee Database?
deCONZ gateway database and service option paths on Linux for ConBee Zigbee coordinator use. Plus migration notes.
Last updated
deCONZ keeps Zigbee state in a zll.db file under ~/.local/share/dresden-elektronik/deCONZ. That database holds paired devices, groups, and scenes. Gateway options live in ~/.config/dresden-elektronik nearby.
Docker installs map the same pair through volumes. The coordinator stick plus database identifies the mesh. Back up zll.db with gateway configs. Losing the database means re-pairing every device by hand. Touchlink commissions bulbs without hubs. Source routing fixes large mesh dropouts. OTA updates need repos enabled.
Where deCONZ stores this, by platform
~/.local/share/dresden-elektronik/deCONZ/zll.db
Paired device database with groups and scenes inside. Copy with the gateway stopped for consistency. Travels with the coordinator stick.
~/.config/dresden-elektronik/deconz.conf
Gateway ports and options for the deCONZ service. Back up with zll.db. Headless installs keep equivalents in systemd units.
Frequently asked questions
what do i back up for a deCONZ move
Copy ~/.local/share/dresden-elektronik/deCONZ with the zll.db file. It holds paired devices and groups. The config in ~/.config covers gateway options. Both restore the mesh.
can I move deCONZ to a new coordinator stick
Yes. Pairing keys live in zll.db, so the same coordinator stick plus database restores the mesh. New sticks need fresh pairing. Keep the database with the hardware.
Notice an outdated path? Let us know.