homelab-infra/ops/restore-tests/unraid-user-scripts.md

Unraid User Scripts fuer Restore-Checks

Ziel

Diese Vorlagen binden die validierten Restore-Checks in Unraid User Scripts ein.

Host-Repo-Pfad:

/mnt/user/services/homelab-infra

Script 1 - restore-freshness-weekly

Zeit:

• Montag, 06:30

Inhalt:

#!/bin/bash
bash /mnt/user/services/homelab-infra/ops/restore-tests/run-restore-checks.sh freshness \
  > /mnt/user/backups/restore-reports/freshness-$(date +%F).md

Erwartung:

• prueft Dump-Frische
• prueft Report-Frische
• startet keine Container

Script 2 - restore-vaultwarden-monthly

Zeit:

• 1. Samstag im Monat, 07:00

V1-Inhalt:

#!/bin/bash
bash /mnt/user/services/homelab-infra/ops/restore-tests/run-restore-checks.sh vaultwarden \
  > /mnt/user/backups/restore-reports/vaultwarden-$(date +%F).md

Script 3 - restore-gitea-monthly

Zeit:

• 3. Samstag im Monat, 07:00

V1-Inhalt:

#!/bin/bash
bash /mnt/user/services/homelab-infra/ops/restore-tests/run-restore-checks.sh gitea \
  > /mnt/user/backups/restore-reports/gitea-$(date +%F).md

Script 4 - restore-paperless-bimonthly

Zeit:

• jeder 2. Monat, 2. Samstag, 08:00

V1-Inhalt:

#!/bin/bash
bash /mnt/user/services/homelab-infra/ops/restore-tests/run-restore-checks.sh paperless \
  > /mnt/user/backups/restore-reports/paperless-$(date +%F).md

Stand

• die Bash-Jobs wurden am 2026-05-07 hostseitig erfolgreich verifiziert
• freshness, vaultwarden, gitea und paperless laufen damit prinzipiell automatisch
• ntfy kann jetzt optional per Wrapper-Skript ergaenzt werden

V2 Zielbild

Als naechster Ausbau kommen dazu:

1. Restore aus Borg
2. Testcontainer starten
3. Smoke-Test
4. Report schreiben
5. optional ntfy
6. Bereinigung

Optionales ntfy Wrapper-Muster

Wenn ntfy genutzt wird, soll der Host-Job nur Erfolg/Fehler referenzieren, nicht den ganzen Report in die Nachricht kippen.

Beispiel:

#!/bin/bash
bash /mnt/user/services/homelab-infra/ops/restore-tests/run-restore-job-with-ntfy.sh freshness homelab-info

Fehler gehen unabhaengig vom Erfolgstopic nach homelab-alerts, damit Restore-Probleme auf dem gleichen Handy-Topic landen wie Prometheus-, Docker-, Borg- und Posture-Alarme.

Verwendete Hilfsskripte:

• ops/restore-tests/send-ntfy.sh
• ops/restore-tests/run-restore-job-with-ntfy.sh