Troubleshooting

HTTPS / Zertifikat wird nicht ausgestellt

• Wildcard-DNS: *.<DOMAIN> muss auf die Server-IP zeigen
• HETZNER_API_TOKEN in .env korrekt; DNS-01 braucht API-Zugriff auf die Zone
• Traefik-Logs: cas logs traefik oder Dateien unter ~/cas/traefik/logs/
• acme.json unter ~/cas/traefik/certs/ — Rechte nur für Traefik-User/Container

OpenClaw Gateway „unhealthy“ oder UI verbindet nicht

• Healthcheck: curl -f http://127.0.0.1:18789/healthz im Gateway-Container
• Token in der UI = Wert aus OPENCLAW_GATEWAY_TOKEN
• allowedOrigins in openclaw.json für deine exakten HTTPS-URLs
• Logs: cas logs openclaw-gateway

Doc-Seite 404 oder leer

• Container cas-docs läuft? docker ps / cas status
• Bind-Mount: Host-Pfad /opt/cas/repo/docs/site muss existieren und index.html enthalten
• Nach manuellem Klon: Repo-Pfad von /opt/cas/repo abweichend → Compose-Volume anpassen
• DNS: doc.<DOMAIN> unter Wildcard erreichbar?

Docker-Netzwerk proxy

Traefik und öffentlich geroutete Dienste hängen am externen Netz proxy. Wird es manuell gelöscht während Container laufen, Routing bricht. Wiederherstellung: Netz neu anlegen, Stack neu starten — siehe cas setup / Phase 1.

cas update --self schlägt fehl

Meldung „Repo nicht gefunden“: /opt/cas/repo fehlt (kein Standard-Bootstrap). Dann CLI nur per manuellem Git-Update des Installationspfads aktualisieren.

Deinstallation / Neuaufsetzen

sudo cas uninstall --yes

Anschließend erneut cas setup. --purge-images entfernt referenzierte Images für schlanke Neuinstallation.

Weitere Diagnose

cas status
cas logs --no-follow
docker compose -f /home/cas/cas/docker-compose.yml ps