Files
homelab-infra/docs
Micha 1a4593110a nearline: S4U-Root-Cause dokumentiert + Exitcode-Leak gefixt
Diagnose 2026-06-21: Der Scheduled Task "KalliLab H Drive Nearline Pull"
lief als LogonType S4U (ohne gespeichertes Passwort) und hatte damit keine
Netzwerk-Anmeldeinformationen fuer den SMB-Share \192.168.178.58\backups.
Jeder geplante 05:30-Lauf brach still mit Exit 1 ab, ohne Report; der
Nearline-Spiegel war 2026-06-19 bis 2026-06-21 veraltet. Manuell nachgezogen,
Spiegel wieder frisch.

pull-critical-backups.ps1: explizites `exit 0` auf dem Erfolgspfad, damit der
letzte robocopy-Exitcode (1 = "Dateien kopiert") nicht als Prozess-Exit leakt
und der Scheduled Task ein wahrheitsgemaesses Ergebnis meldet.

README: Pflicht-Hinweis, dass der Task mit gespeichertem Passwort (nicht S4U)
laufen muss. MASTER_TODO: Root-Cause + verbleibender Operator-Schritt.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 18:02:58 +02:00
..
@
2026-06-16 10:51:16 +02:00
2026-06-17 21:49:33 +02:00

Documentation Index

Typ: Einstieg/Index · Stand: 2026-06-11 · Status: aktiv

Diese Datei trennt aktive Betriebsdokumentation von historischer Arbeitsdoku. Neue operative Dokumente duerfen nur in docs/ liegen, wenn sie heute als Einstieg, Runbook, Inventar, Entscheidung oder Statusliste gebraucht werden. Abgeschlossene Audits, Drills und Plaene wandern nach archive/ oder werden geloescht (Git-Historie ist das Archiv). Verbindliche Doku-Regeln: REPO_MAP.md Abschnitt "Doku-Regeln".

Pflicht-Einstieg

Datei Zweck
../README.md kurzer Repo-Einstieg
../AGENTS.md Einstiegspunkt fuer KI-Agenten (Codex u. a.)
../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 + Doku-Regeln
SERVICE_CATALOG.md produktiver Service-Katalog
DECISIONS.md Entscheidungs-Register (ADR-light)
MASTER_TODO.md einzige operative Statusliste

Betrieb und Recovery

Datei Zweck
DISASTER_RECOVERY.md Wiederanlauf nach Host-/Systemausfall
RESTORE_MATRIX.md Restore-Quellen, Dumps, Secrets, Smoke-Tests und Test-Reifegrad je Dienst
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
DR_WORKSTATION_SETUP.md DR-Gaming-PC einrichten (WSL2 + Borg-Client + SSH-Keys)
../ops/restore-tests/README.md Restore-Test-Betrieb, Skripte und Kadenz

Inventare und Policies

Datei Zweck
STORAGE_LAYOUT.md verbindliche Storage-/Share-/Pfad-Regeln
SECRETS_MAP.md Secret-Namen, Speicherorte und Einbindungsarten ohne Werte
AUTHELIA_OIDC_PLAN.md Plan & Runbook fuer app-uebergreifendes SSO via Authelia OIDC
HARDWARE_INVENTORY.md Host-, Disk-, SMART- und Power-Baseline
NETWORK_INVENTORY.md Router, DNS, Tailscale, Portfreigaben und Netzthemen
GUEST_IOT_NETWORK.md Sicherer Ablauf fuer FRITZ!Box-Gastnetz / IoT-Isolation
EXTERNAL_DEPENDENCIES.md Provider, Konten, DR-Workstation-Kit und externe Abhaengigkeiten
EXTERNAL_OPERATOR_RUNBOOK.md Hetzner-/Borg-/FRITZ!Box-Betreibercheck
CAPACITY_AND_LIFECYCLE.md Kapazitaet, Wachstum, Upgrade-Trigger, H:/-Nearline-Einordnung

Monitoring und Automatisierung

Datei Zweck
ALERT_RULES.md Prometheus-/ntfy-Regeln und Handlungslogik
RENOVATE.md Self-hosted Renovate gegen Gitea
runbooks/komodo-bulk-deploy-dns.md Bulk-Deploy-Pulls scheitern an DNS bei AdGuard-Recreate
../ops/h-drive-nearline/README.md Windows-H:/ Nearline-Pull fuer kritische Restore-Artefakte

Nutzer- und Statusdoku

Datei Zweck
FAMILY_ONBOARDING.md familienverstaendliche Nutzungsdoku
AI_CONTEXT.md kompakter Kontext fuer KI-Agenten (Regeln + Pointer, kein Status)
homelab-optimierung.md technisches Optimierungs-Assessment 2026-06-10 (offene Empfehlungen)

Archiv

Abgeschlossene Snapshots, Drills und Audits: archive/README.md. Windows-Neuaufsetzen-Doku (Projekt abgeschlossen) liegt ebenfalls dort; aktiv geblieben sind nur Veeam-Baseline und Laufwerksstruktur unter ../ops/windows-reinstall/.