--- schema_version: 1 id: home-server.backups type: reference scope: [jupiter, backrest, restic, google-drive, recovery] sensitivity: private-infrastructure last_reviewed: "2026-10-26" sources: - kind: owner-report reference: "Live AirVPN downloads; qBittorrent state/defaults and AirVPN WireGuard secrets not yet added to encrypted off-host backups, 2026-10-26" - kind: owner-report reference: "Backrest plan JSON, destination, key custody and no restore test, 2026-10-06" - kind: owner-report reference: "Updated four-service Backrest plan and deployed Portainer bind mount/container name, 2026-10-06" - kind: owner-report reference: "Only restic key has independent custody; no independent credential recovery or backup/restore evidence, 2026-10-06" - kind: owner-report reference: "Updated six-directory Backrest plan including Authentik and Wardrowbe, deployed Authentik hook container names confirmed; independent recovery custody unchanged, 2026-10-16" - kind: owner-report reference: "Backrest notifications received in Discord server Jupiter, channel #backrest-alerts, 2026-10-23" - kind: repository repository: jupiter-stacks revision: d09df456ad331b8beb9a40615114ea8aae2dced5 paths: - stacks/backrest/docker-compose.yml - stacks/gitea/docker-compose.yml - stacks/paperless-ngx/docker-compose.yml - stacks/vaultwarden/docker-compose.yml - stacks/authentik/docker-compose.yml - stacks/wardrowbe/docker-compose.yml related: [home-server.reference, home-server.downloads, home-server.storage, home-server.portainer, home-server.authentication, home-server.operations] update_triggers: [backup-plan-change, destination-change, hook-change, credential-change, restore-test] unknowns: - last-successful-backup-and-repository-check - google-drive-repository-path - measured-rpo-and-rto --- # Backups | Setting | Value | | --- | --- | | Engine | Backrest / restic; plan `jupiter-backup` | | Repository | `jayo60013-gdrive`; Google Drive; account `jayo60013` | | Schedule | `0 3 * * *`; UTC; daily 03:00 | | Retention | `policyKeepLastN: 4`; last four snapshots, not four days | | Encryption key | iCloud password app; no key stored here | | Independent credential recovery | None beyond the restic encryption key | | Backup / integrity evidence | None supplied | | Restore test | Never performed | ## Notifications Backrest notifications are delivered to **Jupiter** (Discord server) in `#backrest-alerts`; receipt confirmed by the owner on 2026-10-23. Exact enabled hook conditions have not been recorded. Delivery alone does not confirm backup integrity, successful application restarts or detection of a backup that never runs. See [Observability](operations.md#observability) for the shared notification destinations and remaining coverage gaps. ## Coverage Backrest bind-mounts host `/data` at container `/userdata:ro`. | Host source | Plan path | | --- | --- | | `/data/authentik` | `/userdata/authentik` | | `/data/gitea` | `/userdata/gitea` | | `/data/paperless-ngx` | `/userdata/paperless-ngx` | | `/data/portainer` | `/userdata/portainer` | | `/data/vaultwarden` | `/userdata/vaultwarden` | | `/data/wardrowbe` | `/userdata/wardrowbe` | Case-insensitive exclusions: `/userdata/gitea/gitea/packages`, `/userdata/wardrowbe/redis`. `excludes: []`; CLI `--skip-if-unchanged` supplied despite plan `skipIfUnchanged: false`. Unchanged runs may create no snapshot. ### Local-downloads recovery gap The owner confirms on 2026-10-26 that the live [AirVPN download stack](downloads.md) has **not** yet been added to encrypted off-host backups. Missing recovery state: `/data/qbittorrent/config` (settings/torrent state), `/data/qbittorrent/defaults` (defaults and startup/resolver files), and `/data/gluetun/secrets` (WireGuard private/preshared keys). The reserved peer port, tunnel address and server-country settings also need recoverable deployment configuration; no secret values belong in these notes. Torrent payloads and media libraries remain outside the six-directory plan. Hardlinks are not backups. Ultra.cc is retired and is no longer a remote source to assume during recovery. Removing `rclone-seedbox.service` does not remove Backrest's separate Google Drive/rclone dependency. ## Consistency hooks Stop timeout `120s`; chains use `&&`. Errors: `ON_ERROR_FATAL`, except Portainer, Wardrowbe and Authentik restart hooks (`ON_ERROR_IGNORE`). Rows below group the supplied hooks by service; the plan lists Wardrowbe's hooks before Authentik's. | Event | Ordered commands / containers | | --- | --- | | `SNAPSHOT_START` | Stop `paperless` -> `paperless_db` | | `SNAPSHOT_START` | Stop `gitea_runner` -> `gitea` -> `gitea_db` | | `SNAPSHOT_START` | Stop `vaultwarden` | | `SNAPSHOT_START` | Stop `portainer` | | `SNAPSHOT_END`, `SNAPSHOT_ERROR` | Start `paperless_db` -> `paperless` | | `SNAPSHOT_END`, `SNAPSHOT_ERROR` | Start `gitea_db` -> `gitea` -> `gitea_runner` | | `SNAPSHOT_END`, `ANY_ERROR` | Start `vaultwarden` | | `SNAPSHOT_END`, `SNAPSHOT_ERROR` | Start `portainer`; ignore hook failure | | `SNAPSHOT_START` | Stop `wardrowbe-frontend`, `wardrowbe-backend`, `wardrowbe-worker`, `wardrowbe-image-worker` in one command -> stop `wardrowbe-postgres`, `wardrowbe-redis` | | `SNAPSHOT_END`, `SNAPSHOT_ERROR` | Start `wardrowbe-postgres`, `wardrowbe-redis` -> wait for PostgreSQL and Redis -> start backend, worker, image-worker, frontend; ignore hook failure | | `SNAPSHOT_START` | Stop `authentik-server`, `authentik-worker` in one command -> stop `authentik-postgresql` | | `SNAPSHOT_END`, `SNAPSHOT_ERROR` | Start `authentik-postgresql` -> wait for PostgreSQL -> start `authentik-server`, `authentik-worker`; ignore hook failure | Cold filesystem copies of applications/databases; no database dumps supplied. Paperless broker stays running. Paperless/Gitea restart chains use `docker start` without waiting for database readiness. Wardrowbe waits inside the containers using `pg_isready -U wardrowbe -d wardrowbe` then `redis-cli ping`; Authentik uses `pg_isready -U authentik -d authentik`. These are `until` loops with two-second sleeps and no explicit deadline in the commands. Starting multiple application containers in one command does not establish application readiness or dependency ordering. The owner confirms the three Authentik hook names match deployed containers. Repository Compose explicitly names only `authentik-server`; worker/database names must be preserved or the hooks updated when recreating the stack. Hook failure can leave services stopped; Portainer, Wardrowbe and Authentik restart failures do not fail the backup operation. Authentik downtime also interrupts new OIDC logins and proxy-protected access, including the Backrest UI. Application readiness and recovery are not demonstrated by the plan. ## Backrest state | Host path | Container path | | --- | --- | | `/data/backrest/data` | `/data` | | `/data/backrest/config` | `/config`; plan/repository configuration `config.json` | | `/data/backrest/rclone` | `/root/.config/rclone` | | `/home/jay/data/backrest/cache` | `/cache` | | `/data/backrest/restore` | `/restore` | | `/var/run/docker.sock` | `/var/run/docker.sock`; lifecycle hooks | ## Recovery limits Only the six listed directories are covered, subject to the exclusions above. Authentik identity/MFA state and Wardrowbe PostgreSQL/uploads are included; Wardrowbe Redis is excluded. SSD-backed Wardrowbe model/cache paths are outside the plan. No supplied coverage for Traefik, Backrest configuration, Docker named volumes, OS, or Mercury. Authelia is retired; old data retention is unconfirmed. Full-host recovery requires independently retrievable repository credentials, configuration and restic key. Key custody alone does not establish recoverability. No independent Google Drive/rclone credential recovery or Backrest-config recovery arrangement exists. Recovering backed-up Portainer state is not a substitute for first being able to retrieve the backup. `/restore` is on the same RAID array; not an independent backup.