Schwierigkeit: Mittel · Dauer: 45–90 Min · Ziel: Nginx Proxy Manager mit Let's Encrypt: saubere Reverse-Proxy-Basis
Kurzproblem und Zielbild
Viele Homelab-Setups sind im Alltag schwer wartbar: Änderungen wirken auf mehrere Ebenen, Fehler sind nicht sauber eingegrenzt und Checks fehlen. Dieser Guide liefert einen praxisnahen Ablauf mit reproduzierbaren Schritten und klaren Kontrollpunkten.
Voraussetzungen
- Linux-/CLI-Grundlagen
- Admin-Zugriff auf die Zielsysteme
- Snapshot/Backup vor Änderungen
Schnellstart (funktionierende Basis)
hostnamectl
ip a
systemctl --failed
journalctl -p 3 -xb --no-pager | tail -n 30Schritt-für-Schritt Umsetzung
1) Ausgangszustand dokumentieren
date -Iseconds
uname -a
# aktuelle Versionen und relevante Konfig-Pfade notieren2) Kernkonfiguration sauber setzen
docker compose up -d
docker logs --tail 100 nginx-proxy-manager
curl -I http://localhost:813) Dienst/Funktion gezielt prüfen
curl -I https://deine-domain.tld
docker exec -it nginx-proxy-manager ls -lah /etc/letsencrypt/live4) Betriebsgrenzen testen
# Negativtest/Failover/Fehlerszenario bewusst gegenprüfen
# Ergebnis dokumentieren und Grenzwerte anpassenValidierung / Checks
curl -I https://deine-domain.tld
docker exec -it nginx-proxy-manager ls -lah /etc/letsencrypt/live
# End-to-End Funktion einmal vollständig testenTroubleshooting
Konfiguration wird nicht übernommen
Ursache: Syntax-/Reload-Fehler oder falscher Parameterpfad.
# Syntax/Config prüfen
# betroffenen Dienst neu laden
# Logs erneut analysierenDienst läuft, Funktion aber fehlerhaft
Ursache: Abhängigkeiten, Routing, Rechte oder Versionen inkonsistent.
# Netzwerkpfad und Berechtigungen prüfen
# gezielten Re-Test unter kontrollierten Bedingungen ausführenFazit
Mit einem klaren Ablauf, harten Checks und dokumentierten Grenzwerten bleibt das Setup wartbar statt zufällig stabil. Nächster Schritt: den Ablauf als monatliche Betriebsroutine einplanen.
