homelab-infra/docs/SERVICES_RECOVERY.md

Services Recovery - KalliLab CORE

Status: Initiale Spezifikation, aus dem Audit 2026-05-25 abgeleitet. Verwandte Docs: docs/DISASTER_RECOVERY.md, docs/RESTORE_MATRIX.md, docs/STORAGE_LAYOUT.draft.md, docs/SECRETS_MAP.md

Zweck

Der Share /mnt/user/services/ ist recovery-kritisch, weil dort GitOps- und Host-Automation-Pfade liegen. Dieses Dokument beschreibt, welche Services-Pfade gesichert werden muessen und wie ein Kaltstart ohne laufendes Komodo gedacht ist.

Kritische Pfade

Pfad	Zweck	Kritikalitaet	Backup-Anforderung
/mnt/user/services/homelab-infra	Host-Repo-Clone fuer Automation/Posture	hoch	Borg + GitHub/Gitea Mirror
/mnt/user/services/stacks	Komodo Stack Workspaces	hoch	Borg, vor strukturellen Aenderungen extra sichern
/mnt/user/services/gitea/git/repositories	Gitea Repository-Inhalte	kritisch	Borg + separater Mirror <= 6 h
/mnt/user/services/posture-check	Hostseitig ausgefuehrte Checks	hoch	Borg + Repo-Abgleich
/mnt/user/appdata/secrets	Runtime Secrets	kritisch	Borg + ausgewählte analoge/off-system Kopien

Gitea Repository Mirror

Ziel: Verlustfenster fuer /mnt/user/services/gitea/git/repositories/ auf maximal 6 Stunden begrenzen.

Optionen:

Option	Bewertung
git bundle je Repository auf zweites Medium	Sehr gut fuer Git-Recovery, transparent, gut pruefbar
rsync auf externe Platte oder zweiten Host	Einfach, aber Ziel muss regelmaessig erreichbar und geprueft sein
Separates Borg-Repo mit kurzem Schedule	Konsistent zum bestehenden Backup, aber wieder Borg-/Passphrase-abhaengig

Empfohlener Start:

1. git bundle-Job fuer alle Gitea-Repositories definieren.
2. Ziel auf zweitem physischen Medium oder separatem Off-site-Ziel ablegen.
3. Job alle 6 Stunden ausfuehren.
4. Stichprobe: ein Bundle in Wegwerfpfad klonen.

Erfolgskriterium:

git clone /path/to/repo.bundle /tmp/repo-restore-test
git -C /tmp/repo-restore-test fsck

Komodo Bootstrap

Problem: Komodo verwaltet Stacks, ist aber selbst Teil des Recovery-Pfads. Ein kalter Host darf nicht voraussetzen, dass Komodo schon laeuft.

Minimaler Wiederanlauf:

1. Docker und externe Netze herstellen (frontend_net, backend_net, ggf. weitere dokumentierte Netze).
2. Repo aus Gitea/GitHub Mirror klonen.
3. Komodo Compose aus ops/komodo/docker-compose.yml oder einem spaeteren Bootstrap-Pfad starten.
4. Erforderliche .env/Secrets aus Host-Secret-Backup wiederherstellen.
5. Komodo-Core, Periphery und Mongo starten.
6. Web-UI und Periphery-Verbindung pruefen.

Offene Aufgabe:

• Entscheiden, ob ein eigener Pfad services/komodo-bootstrap/ ins Repo kommt oder ops/komodo/docker-compose.yml die verbindliche Bootstrap-Quelle bleibt.

Validierung:

docker compose -f ops/komodo/docker-compose.yml config
docker compose -f ops/komodo/docker-compose.yml up -d
docker ps --filter "name=komodo"

Secrets Recovery Reihenfolge

Authoritativ ist docs/SECRETS_MAP.md. Fuer den Kaltstart ist diese Reihenfolge praktisch:

1. Borg-Passphrase analog/off-system beschaffen.
2. Borg-Repo-Zugang/SSH-Key wiederherstellen.
3. /mnt/user/appdata/secrets/ aus Borg wiederherstellen.
4. Komodo Stack ENV / Recovery ENV wiederherstellen.
5. Gitea Secrets und SSH-Material wiederherstellen.
6. Traefik/Cloudflare Secret wiederherstellen.
7. App-spezifische Secrets nach Tier-Reihenfolge wiederherstellen.

Break-glass Regeln

• Keine Secret-Werte in Git oder Tickets kopieren.
• Restore-Tests laufen in Wegwerfpfaden, nie direkt gegen produktive Pfade.
• Wenn Gitea und Komodo beide down sind, gewinnt der externe GitHub-Mirror als Repo-Quelle.
• Wenn Borg ohne Passphrase nicht entschluesselbar ist, ist Recovery blockiert. Deshalb ist die analoge Passphrase-Sicherung P0.

Naechste Aufgaben

Status	Aufgabe
offen	Gitea-Bundle- oder Mirror-Mechanik final entscheiden
offen	Komodo-Bootstrap-Quelle finalisieren
offen	Restore-Kommandos nach erstem Trockenlauf mit echten Pfaden ergaenzen
offen	Services-Recovery in docs/DISASTER_RECOVERY.md verlinken