Files
homelab-infra/docs
Micha c47639ecf4 docs(host): Fix Common Problems Plugin deinstalliert (2026-06-03)
Befund: Drei `grep -R ... /usr/local/emhttp`-Prozesse aus einem FCP-Daily-
Scan-Run hingen seit ~7 Tagen in einem Symlink-Loop. Unraids
`/usr/local/emhttp/mnt` ist ein Symlink nach `/mnt` (mehrere TB Array);
GNU `grep -R` dereferenziert Symlinks, also walking die FCP-Scan-Greps
effektiv das gesamte Array. 3 Cores dauerhaft 100 %, IOWAIT-Peaks 55 %,
USB-Flash unter Dauer-IO, Load 14.6 auf 12 Cores.

Massnahme: `plugin remove fix.common.problems.plg`. Cron, Plugin-Dir
und /tmp-Reste sauber. Load von 14.6 auf 1.08 (1-min) gefallen.

Entscheidung: FCP wird bewusst nicht reinstalliert. Begruendung im
Architektur-Master Sektion 13. Verbleibende Risiken decken Scrutiny,
Monitoring, Posture-Check und Critical-Events-Watcher bereits ab.

Repo-Aenderungen:
- HOMELAB_ARCHITECTURE_MASTER_V2.md Sektion 13: vollstaendiger
  Entscheidungs-Log-Eintrag mit Ursache, Massnahme, Begruendung
- AUDIT_2026-05-25_TODO.md "Zuletzt geschlossen": Kurzfassung

Host-Aenderung wurde via SSH durchgefuehrt (read+remove), keine
Compose-/Container-Aenderungen.
2026-06-03 16:29:33 +02:00
..
2026-06-01 12:48:00 +02:00
2026-05-26 15:27:37 +02:00

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/.