homelab-infra/ops/restore-tests/README.md

Restore Tests

Kontrollierte Restore-Tests fuer homelab-infra.

Ziel:

• Backups durch echte Test-Restores verifizieren
• produktive Pfade nicht beschreiben
• Testlaeufe spaeter weitgehend automatisieren

Grundregeln

• Restore-Quelle bleibt im Backup-Bereich, z. B. /mnt/user/backups/borg
• Test-Restores laufen nur in /mnt/user/backups/restore-lab
• Reports landen in /mnt/user/backups/restore-reports
• Test-Container nutzen das Praefix restoretest-
• keine produktiven Volumes schreibend mounten
• keine produktiven Domains fuer Testinstanzen uebernehmen

Geplante Struktur

• schedule.md: Intervalle und Verantwortlichkeiten
• vaultwarden-restore-test.ps1: erster Mini-Restore-Ablauf
• vaultwarden-plan.md: konkreter Vaultwarden-Testplan
• vaultwarden-compose.test.yml: isolierte Testinstanz fuer Vaultwarden
• gitea-restore-test.ps1: Gitea-Mini-Restore-Ablauf
• gitea-plan.md: konkreter Gitea-Testplan
• gitea-compose.test.yml: isolierte Testinstanz fuer Gitea
• spaeter weiterer Test fuer paperless

Automatisierungsmodell

• Ausfuehrung: Unraid User Script / Host-Job
• Logik: Repo-Skripte in diesem Verzeichnis
• Ergebnis: Markdown-Report
• Meldung: ntfy
• Hermes: optional nur fuer Zusammenfassung und Auswertung

Validiertes Grundmuster

Stand nach dem ersten echten Vaultwarden-Test:

• Borg-Quelle bleibt das produktive Remote-Repo bei Hetzner
• Borg-Zugriff laeuft praktisch ueber den vorhandenen borg-ui-Container
• SSH-Trust wird ueber known_hosts im borg-ui-Container hergestellt
• die Borg-Passphrase kommt fuer Restore-Tests aus einer Host-Secret-Datei
• Restore-Ziel liegt immer getrennt unter /mnt/user/backups/restore-lab
• Reports liegen unter /mnt/user/backups/restore-reports
• Testinstanzen bekommen keine produktive Domain und keine Traefik-Route

Das ist das bevorzugte Muster fuer weitere dateibasierte Restore-Tests wie gitea.

Status

Aktuell ist das erste validierte Muster vorhanden.

• echter Vaultwarden-Restore am 2026-05-07 erfolgreich verifiziert
• echter Gitea-Restore am 2026-05-07 erfolgreich verifiziert
• Restore-Lab und Report-Pfade auf dem Host angelegt
• V1-Ablauf weiter ohne ntfy, mit Bereinigung nach Erfolg
• paperless ist der naechste Referenz-Restore

Vor dem ersten echten Testlauf muessen Zielpfade, Quellpfade und Bereinigungsschritte bewusst freigegeben werden.