Backup and Restore

Items to Back Up

• the entire data/ volume;
• the entire downloads/ volume;
• the Compose file and its configuration, without exposing secrets;
• the version of the image used.

Consistent Backup

Briefly stop VidArch before copying the volumes:

docker compose stop vidarch

Copy data/ and downloads/ to an independent location, then restart:

docker compose start vidarch

This method prevents capturing the SQLite database during a write operation.

Restoration

1. Stop the instance;
2. Keep a copy of the current state;
3. Restore the two volumes from the same point in time;
4. Verify permissions;
5. Restart and check /api/health, the library, and a playback.

Regularly test the restoration on an isolated machine.