🛠️ Troubleshooting — wenn was kaputt ist

Ein Tool ist nicht erreichbar (502 / Connection Reset)

# 1. SSH auf den Server
ssh root@168.119.232.59

# 2. Status aller Container
cd /opt/hermes-stack
docker compose ps

# 3. Logs des betroffenen Containers
docker compose logs --tail 100 <name>

# 4. Container neu starten
docker compose restart <name>

Schneller per Browser: https://logs.168-119-232-59.sslip.io/ → Container öffnen → roter Restart-Button oben.

Cert-Fehler im Browser („Verbindung nicht sicher")

Erstmal F5 + 30 Sekunden warten — Caddy holt das Cert beim ersten Request.
Falls das nicht hilft:
bash ssh root@168.119.232.59 systemctl status caddy journalctl -u caddy -n 100 --no-pager
Letzte Notlösung: systemctl restart caddy.

Server reagiert gar nicht mehr

Hetzner Cloud Console → https://console.hetzner.cloud/ → deinen Server → Power → Reset.
Warten ~60s, alles bootet automatisch (systemd + docker compose mit restart: unless-stopped).

Hermes-Panel zeigt Fehler

ssh root@168.119.232.59
systemctl status hermes-panel
journalctl -u hermes-panel -n 100 --no-pager
systemctl restart hermes-panel

Festplatte voll

df -h
docker system prune -a --volumes  # ⚠️ löscht ungenutzte Images/Volumes

Container update einspielen

ssh root@168.119.232.59
cd /opt/hermes-stack
docker compose pull
docker compose up -d
docker image prune -f

→ Lädt neueste Versionen (open-webui:main, n8n:latest, etc.) und startet nur die geänderten Container neu. Volumes (= deine Daten) bleiben erhalten.

Backup wiederherstellen

# Beispiel paperless
ssh root@168.119.232.59
cd /opt/hermes-stack
docker compose down paperless paperless-redis
tar xzf /root/.hermes/backups/paperless-2026-05-21.tgz -C /
docker compose up -d paperless paperless-redis

Caddy-Konfig testen

ssh root@168.119.232.59
caddy validate --config /etc/caddy/Caddyfile
systemctl reload caddy

Feature-Flag-Liste (was aktuell installiert ist)

ssh root@168.119.232.59 "docker ps --format '{{.Names}}: {{.Image}}'"
ssh root@168.119.232.59 "systemctl list-units --type=service --state=running --no-pager --no-legend | head -40"

Zugang verloren (SSH-Key weg)

→ Hetzner Cloud Console → Server → Rescue System booten → Schlüssel neu deployen → reboot.

Wichtige Pfade auf dem Server

/opt/hermes-stack/                  # docker-compose + .env
/opt/hermes-panel/                  # FastAPI Panel + venv
/opt/hermes-panel/app/templates/    # HTML-Templates
/etc/caddy/Caddyfile                # Caddy-Config
/etc/systemd/system/hermes-panel.service
/var/lib/docker/volumes/            # alle Container-Daten
/root/.hermes/backups/              # manuelle Backups
/var/log/caddy/                     # Caddy-Logs
journalctl -u <service>             # systemd-Logs

Fragen die der AI-Chat (Hermes) beantworten kann

„Wie restart ich Container X?" → er kennt diese Doku.
„Welche Ports sind offen?" → er ruft die Panel-API auf (mit Tool-Use).
„Mach mir n8n-Workflow für …" → ja, kann er.

Tipp: copy-paste den Inhalt dieser .md-Dateien in den AI-Chat-Systemprompt → Hermes hat Volltextkontext deines eigenen Setups.