Files

T

Micha 9edd6c24e6 docs(dr): tabletop-folge - DR.md + EXTERNAL_DEPENDENCIES haerten

Reine Doku-Fixes nach DR-Tabletop 2026-06-03 und Operator-Antworten auf
vier offene Fragen.

DISASTER_RECOVERY.md:
- Abschnitt 3 Voraussetzungen: Operator-DR-Workstation als Pflichtposten
- Phase 0: privater GitHub-Mirror, Read-PAT/Deploy-Key, expliziter Repo-
  Bootstrap-Pfad Workstation -> Unraid
- Abschnitt 6.1: homelab_smtp_password.txt, n8n_encryption_key.txt,
  monitoring/influxdb/filebrowser Secrets nachgezogen
- Neuer Abschnitt 7.3: Borg-Extract ohne borg-ui (DR-Workstation oder
  docker run borgbackup/borg), Passphrase-Eingabe interaktiv
- Phase 4 neue Stufe 0 "Docker-Grundlage": docker network create
  frontend_net/backend_net/monitoring_net + dynamic/ Pre-Check
- Phase 4 Stufe 1: LE-Staging-Hinweis bei verlorenem acme.json
- Phase 4 Stufe 3 "Wichtige Stolperfallen": KOMODO_*-Quelle, Mongo-
  Datadir/Secret-Mismatch, extra_hosts-IP, Stack-ENV-Wiederherstellung
- Phase 5.3: App-DB-Verifikation per docker logs

EXTERNAL_DEPENDENCIES.md:
- GitHub-Mirror als privat klargestellt + Read-PAT/Deploy-Key Pflicht
- Operator-DR-Workstation als kritische Abhaengigkeit
- KOMODO_*-Notiz und GitHub-Read-PAT als noch nicht angelegt erfasst
- Hetzner-Maintenance-Key offline bestaetigt (Operator-Antwort 2026-06-03)
- Neuer Abschnitt "DR-Workstation Bare-Metal-Kit" mit konkretem Inhalt

AUDIT_2026-05-25_TODO.md:
- Vier neue P1-Operator-Aufgaben: KOMODO_*-Notiz, Read-PAT, DR-Workstation-
  Setup, Nextcloud-Restore-Test scharf laufen lassen

DR_DRILL_2026-06-03.md:
- Folge-Iteration-Tabelle: welcher Finding wo adressiert wurde

Operator-Aufgaben (nicht delegierbar) sind als P1 markiert. Nichts in
Runtime/Compose beruehrt, kein Container gestartet.

2026-06-03 16:00:00 +02:00

AI_CONTEXT.md

docs: archive rollback volumes after burn-in

2026-06-02 19:55:02 +02:00

ALERT_RULES.md

Trim documentation to active runbooks

2026-05-31 23:26:12 +02:00

AUDIT_2026-05-25_TODO.md

docs(dr): tabletop-folge - DR.md + EXTERNAL_DEPENDENCIES haerten

2026-06-03 16:00:00 +02:00

CAPACITY_AND_LIFECYCLE.md

Validate backup follow-up and harden nearline pull

2026-06-01 08:27:52 +02:00

DISASTER_RECOVERY.md

docs(dr): tabletop-folge - DR.md + EXTERNAL_DEPENDENCIES haerten

2026-06-03 16:00:00 +02:00

DR_DRILL_2026-06-03.md

docs(dr): tabletop-folge - DR.md + EXTERNAL_DEPENDENCIES haerten

2026-06-03 16:00:00 +02:00

EXTERNAL_DEPENDENCIES.md

docs(dr): tabletop-folge - DR.md + EXTERNAL_DEPENDENCIES haerten

2026-06-03 16:00:00 +02:00

EXTERNAL_OPERATOR_RUNBOOK.md

Record append-only operator decision

2026-06-01 15:16:56 +02:00

FAMILY_ONBOARDING.md

Focus family onboarding on core apps

2026-06-01 15:25:48 +02:00

GITOPS_DRIFT_RUNBOOK.md

Consolidate monitoring target stack

2026-05-17 10:41:29 +02:00

H_DRIVE_NEARLINE_PULL.md

Validate backup follow-up and harden nearline pull

2026-06-01 08:27:52 +02:00

HARDWARE_INVENTORY.md

Trim documentation to active runbooks

2026-05-31 23:26:12 +02:00

HOME_ASSISTANT_INFLUXDB_ECOWITT.md

Consolidate monitoring target stack

2026-05-17 10:41:29 +02:00

NETWORK_INVENTORY.md

Document fritzbox config backup

2026-06-01 14:19:13 +02:00

README.md

Prepare external operator checks

2026-06-01 12:48:00 +02:00

RENOVATE.md

Trim documentation to active runbooks

2026-05-31 23:26:12 +02:00

REPO_MAP.md

Trim documentation to active runbooks

2026-05-31 23:26:12 +02:00

RESTORE_HANDBOOK.md

docs(restore): finalize audit - handbook update, reifegrad matrix, backlog

2026-06-03 09:31:19 +02:00

RESTORE_MATRIX.md

docs(restore): traefik restore successful - 11 of 12 tests green

2026-06-03 14:45:27 +02:00

ROLLBACK.md

Remove legacy monitoring stacks

2026-05-26 15:27:37 +02:00

SECRETS_MAP.md

revert: remove social-to-mealie-plus stack

2026-06-02 19:44:35 +02:00

SERVICE_CATALOG.md

docs: archive rollback volumes after burn-in

2026-06-02 19:55:02 +02:00

SERVICES_RECOVERY.md

Trim documentation to active runbooks

2026-05-31 23:26:12 +02:00

STORAGE_LAYOUT.md

Trim documentation to active runbooks

2026-05-31 23:26:12 +02:00

WORKFLOW.md

Trim documentation to active runbooks

2026-05-31 23:26:12 +02:00

README.md

Documentation Index

Stand: 2026-06-01

Diese Datei trennt aktive Betriebsdokumentation von historischer Arbeitsdoku. Neue operative Dokumente duerfen nur in docs/ liegen, wenn sie heute als Einstieg, Runbook, Inventar oder offene Arbeitsliste gebraucht werden. Erledigte Audits, Chat-Handoffs, Prompt-Dateien und abgeschlossene Plaene bleiben in der Git-Historie, aber nicht als dauerhafte Arbeitskopie.

Pflicht-Einstieg

Datei	Zweck
`../README.md`	kurzer Repo-Einstieg
`../HOMELAB_ARCHITECTURE_MASTER_V2.md`	Architektur-Quelle fuer Netz, Zugriff und Ausnahmen
`WORKFLOW.md`	verbindlicher GitOps-/No-Drift-Ablauf
`REPO_MAP.md`	technische Landkarte des Repositories
`SERVICE_CATALOG.md`	produktiver Service-Katalog

Betrieb und Recovery

Datei	Zweck
`DISASTER_RECOVERY.md`	Wiederanlauf nach Host-/Systemausfall
`RESTORE_MATRIX.md`	Restore-Quellen, Dumps, Secrets und Smoke-Tests je Dienst
`RESTORE_HANDBOOK.md`	praktische Restore-Anleitung
`SERVICES_RECOVERY.md`	Gitea-/Komodo-/Services-Bootstrap
`ROLLBACK.md`	Rueckweg bei GitOps-/Deploy-Fehlern
`GITOPS_DRIFT_RUNBOOK.md`	Pflichtmatrix bei Drift zwischen Git, Komodo, Docker und Host

Inventare und Policies

Datei	Zweck
`STORAGE_LAYOUT.md`	verbindliche Storage-/Share-/Pfad-Regeln
`SECRETS_MAP.md`	Secret-Namen, Speicherorte und Einbindungsarten ohne Werte
`HARDWARE_INVENTORY.md`	Host-, Disk-, SMART-, USV- und Power-Baseline
`NETWORK_INVENTORY.md`	Router, DNS, Tailscale, Portfreigaben und Netzthemen
`EXTERNAL_DEPENDENCIES.md`	Provider, Konten und externe Abhaengigkeiten
`EXTERNAL_OPERATOR_RUNBOOK.md`	Hetzner-/Borg-/FRITZ!Box-Betreibercheck
`CAPACITY_AND_LIFECYCLE.md`	Kapazitaet, Wachstum und Upgrade-Trigger

Monitoring und Automatisierung

Datei	Zweck
`ALERT_RULES.md`	Prometheus-/ntfy-Regeln und Handlungslogik
`RENOVATE.md`	Self-hosted Renovate gegen Gitea
`HOME_ASSISTANT_INFLUXDB_ECOWITT.md`	Home Assistant -> InfluxDB 3 -> Grafana
`H_DRIVE_NEARLINE_PULL.md`	Windows-H:/ Nearline-Pull fuer kritische Restore-Artefakte

Nutzer- und Planungsdoku

Datei	Zweck
`FAMILY_ONBOARDING.md`	familienverstaendliche Nutzungsdoku
`AUDIT_2026-05-25_TODO.md`	kompakte Restliste aus dem Audit-Zyklus
`AI_CONTEXT.md`	kompakter Kontext fuer KI-Agenten

Windows-Neuaufsetzen-Dokumente liegen nicht mehr in docs/, sondern im fachlich passenden Ordner ../ops/windows-reinstall/docs/.