Where Does Citadel Store Node and App Data?
Where Citadel keeps app data, Bitcoin state and configs on its server drive for backup and recovery.
Last updated
Citadel follows the Umbrel family layout on its server drive: an app-data tree with per app configs and databases, plus chain and channel state beside it for node apps. The OS lives on separate media from the data that matters.
Back up with services stopped; channel and database state dislike live copies. Seeds plus fresh channel backups form the rescue kit for Lightning funds. Keep install notes with the backup so restores land on matching versions.
Where Citadel stores this, by platform
~/citadel/app-data
App configs and node state under the Citadel root on the data drive. Layout mirrors the Umbrel family; confirm locally. Stop services before copying.
Frequently asked questions
How do I back up a Citadel node?
Stop the stack and copy the app-data tree plus any mounted data volumes and your compose setup. App configs travel in app-data, chain state beside it. One half alone restores poorly.
My Citadel paths differ from guides. Which is right?
Read the install directory layout on your machine; paths follow the Umbrel family pattern with a Citadel root. Guides show examples while your folders show the live install. Confirm before scripting.
Notice an outdated path? Let us know.