Back Up Your Self-Hosted NetBird Installation

To back up your NetBird installation, you need to copy the configuration files and the Management service databases.

The configuration files are located in the folder where you ran the installation script. To back up, copy the files to a backup location:

mkdir backup
cp docker-compose.yml dashboard.env config.yaml backup/

For detailed information about each configuration file and its options, see the Configuration Files Reference.

To save the server databases, stop the server and copy the files from the data directory:

docker compose stop netbird-server
docker compose cp -a netbird-server:/var/lib/netbird/ backup/
docker compose start netbird-server

Older Setup (Separate Containers)

If your deployment uses the older setup with separate containers (management, signal, relay, coturn), back up the configuration files:

mkdir backup
cp docker-compose.yml Caddyfile dashboard.env management.json relay.env backup/

To save the Management service database:

docker compose stop management
docker compose cp -a management:/var/lib/netbird/ backup/
docker compose start management

Feel free to ping us on Slack if you have any questions.