Back up and restore your Docker folder
Use Tools > Backups to save a copy of your Docker folder, bring an old copy back, and clean up backups you no longer need. Make a backup before you change something big, such as setting up the Docker folder again. What can overwrite or delete your changes lists the actions to back up before.
Before you start
Section titled “Before you start”- You have a Pro license. The Backups screen opens for every license, but each option on it needs Pro. Without it you see a “Requirements Not Met” box.
- You finished Prerequisites. Backup, View and Delete need it. See the Quick start.
- For Restore, you accepted the Disclaimers. Restore does not need the rest of Prerequisites.
What a backup contains
Section titled “What a backup contains”A backup holds your whole Docker folder: the compose files, the .env file and the app data.
It does not hold anything outside the Docker folder. For example, media on a mounted share is not in the backup. For what the Docker folder holds, see What is in your Docker folder.
Each backup is one file named after the date and time it was made, like 20261109_143000.tar.gz.
Where backups are stored
Section titled “Where backups are stored”Set the backups folder in Prerequisites > Backups Folder (Set Backups Folder). Deployrr recommends /home/USERNAME/docker_backups, where USERNAME is your Linux user.
If you open Tools > Backups and the folder does not exist, Deployrr creates it. It shows “Backup folder created. Here is where all your backups will be stored:” and the path.
If you change the backups folder path, move your existing backups to the new place yourself. Deployrr does not move them.
For a short look at the backup location options in v6, watch Deployrr 6 overview: backup locations and other new options at 9:08.
The Backups screen
Section titled “The Backups screen”The top of the screen shows Backup Folder, Number of Backups and Size of Backups (in MB). These numbers cover only the default backups folder. The size is for everything in that folder, not only backups.
Under BACKUPS you get these options:
| Option | What it does |
|---|---|
| Backup | Backs up the Docker folder. |
| View | Lists your backups. |
| Restore | Restores a backup. |
| Delete | Deletes backups. |
Under MIGRATION you get MP Create and MP Restore. They create and restore a migration package, which is for moving to a new server. See Move Deployrr to a new server.
Back up the Docker folder
Section titled “Back up the Docker folder”To see a backup made on screen, watch Deployrr 5 walkthrough: Backups menu and making a backup at 1:18:00 (shows Deployrr v5; menus and steps differ in v6).
-
In Deployrr, go to Tools > Backups.
-
Choose Backup.
-
In the Backup Location box, choose where to save the backup. Pick Use default folder or Select a custom folder.
-
Read the WARNING box. It says all running containers will be stopped.
-
Move to Yes and confirm.
The No button is on the left and Yes is on the right. No is selected by default.
-
Wait. Deployrr stops your apps and creates the backup. It says “This may take several minutes depending on data size…”.
-
Look for “Backup completed:” followed by the path of your new file.
-
Answer “Do you want to restart the Docker stack?”. Press
Yto start your apps again.
If something goes wrong you see “Backup could not be found:” and the path.
See your backups
Section titled “See your backups”- Go to Tools > Backups.
- Choose View.
You get a list of the files in the default backups folder, newest first. Any other files you put in that folder show up too.
Backups you saved to a custom folder are not in this list.
Restore a backup
Section titled “Restore a backup”-
Go to Tools > Backups.
-
Choose Restore.
-
In the Restore Location box (“Where do you want to restore from?”), pick the default folder or a custom folder.
-
Read the WARNING box. It says all running containers will be stopped and shows the folder you restore from.
-
Move to Yes and confirm. No is on the left and selected by default.
-
In the file browser, use
TABto move around andSPACEBARto select a.tar.gzfile. -
Choose Confirm. If you picked something that is not a
.tar.gzfile, the browser opens again.If you select nothing, you see “No backup file selected or operation canceled.”
-
Answer “Do you want to create a current backup before restoring the selected backup (y/n)?”.
Press
nto skip it. Any other key makes a backup of your current state first. That backup goes in the default backups folder. -
Wait for “Restore completed.”
-
Answer “Do you want to restart the Docker stack?”. Press
Yto start your apps.
Delete old backups
Section titled “Delete old backups”- Go to Tools > Backups.
- Choose Delete.
- Choose the location of the backup. This box uses the same wording as Restore (“Where do you want to restore from?”).
- In the Delete a Backup file browser, select the file with
SPACEBAR. - Choose Confirm.
- At “Are you sure you want to delete the backup file:” move to Yes and confirm. No is on the left and selected by default.
You see the file name followed by “deleted successfully.”
Check it worked
Section titled “Check it worked”- After a backup to the default folder, choose View. The new file is at the top of the list.
- After a restore, answer
Yto restart the stack. Your apps come back with their old settings. - After a delete, the file is no longer in the View list.
If your apps don’t come back after a restore
Section titled “If your apps don’t come back after a restore”-
Go to Tools > Stack Manager and choose Up. It starts every app in your compose files. It needs a Basic, Plus or Pro license and finished Prerequisites. See Stack Manager.
-
If one app keeps restarting, read its log:
Terminal window sudo docker logs APP --tail 50With the Deployrr aliases,
dlogs APPshows the same lines with timestamps and keeps following the log. PressCtrl+Cto stop. See A container keeps restarting, is unhealthy or has exited. -
Scroll back through the restore output and look for error lines. Deployrr deletes the old Docker folder before it unpacks the backup, so an error there can leave the folder incomplete. Run Restore again with the same backup, and this time press
nat the question about a current backup. The backup of your state before the first restore (step 8 of Restore a backup) is in the default backups folder, even if you restored from a custom folder.
Back up one app’s database
Section titled “Back up one app’s database”Backup stops every app, so the databases in it are safe to restore. If you copy an app’s database folder by hand while it runs, the copy can be broken. Use one of these ways instead. The container names, users and database names are in Change a database password safely. YOUR_DOCKER_FOLDER is your Docker folder and USERNAME is your Linux user.
Supabase (supabase-db) and TeslaMate (teslamate-pgsql) use other names and have several containers on their database. Use Backup for those. For the standalone MariaDB or PostgreSQL app, the container is just mariadb or postgresql.
Stop the database, then copy its folder. This works for every app with an APP-postgresql or APP-mariadb container:
sudo docker stop APPsudo docker stop APP-postgresqlsudo cp -a YOUR_DOCKER_FOLDER/appdata/APP-postgresql /home/USERNAME/APP-postgresql-copysudo docker start APP-postgresqlsudo docker start APPWith the Deployrr aliases, dcstop APP-postgresql APP and dcstart APP-postgresql APP stop and start the same containers. Always give the names: dcstop on its own stops every app.
Use APP-mariadb for a MariaDB app. If the app has more containers that use the database, such as authentik-worker or langfuse-worker, stop them too and start them last. To restore, stop the same containers, rename the database folder in appdata, copy your copy back with sudo cp -a under the old name, and start the containers again. If docker start says there is no such container (for example after Backup or Down removed them), use Stack Manager > Up instead.
PostgreSQL: dump while it runs. This makes one .sql file and keeps the app running:
sudo docker exec APP-postgresql pg_dump -U DB_USER -d DB_NAME --clean --if-exists > APP-db.sqlTo restore it, stop the app, load the file, then start the app:
sudo docker stop APPsudo docker exec -i APP-postgresql psql -U DB_USER -d DB_NAME < APP-db.sqlsudo docker start APPMariaDB: dump while it runs. The root password is already inside the container, either as a variable or in a secret file. This command reads it there, so you don’t type it and it doesn’t end up in your shell history:
sudo docker exec APP-mariadb sh -c 'mariadb-dump -u root -p"${MARIADB_ROOT_PASSWORD:-$(cat "$MARIADB_ROOT_PASSWORD_FILE")}" --single-transaction --databases DB_NAME' > APP-db.sqlKeep the single quotes. They make the container, not your server, fill in the password. To restore, stop the app, load the file, then start the app:
sudo docker stop APPsudo docker exec -i APP-mariadb sh -c 'mariadb -u root -p"${MARIADB_ROOT_PASSWORD:-$(cat "$MARIADB_ROOT_PASSWORD_FILE")}"' < APP-db.sqlsudo docker start APPThis also replaces the tables in the current database, so dump the current state first, as for PostgreSQL.
For Immich, use the folder copy. Its database has extensions that need extra restore steps.
Keep a copy elsewhere
Section titled “Keep a copy elsewhere”A backup on the same disk does not help if that disk fails. Copy the backups you care about to another disk or another machine.

