1

Fehlerbehebung

opencode edited this page 2026-10-20 20:10:15 +02:00

Table of Contents

• Fehlerbehebung

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Fehlerbehebung

Symptom	Ursache / Lösung
Caddy holt kein Zertifikat	DOMAIN in .env prüfen; DNS A/AAAA-Record und Ports 80/443 prüfen; docker compose logs caddy
http:// leitet nicht auf HTTPS um	Caddy-Logs prüfen; DOMAIN muss die öffentliche Domain sein (nicht localhost)
OIDC-Login scheitert (/login?sso=pruefung-fehlgeschlagen)	Redirect-URI in Authentik exakt prüfen (https://<DOMAIN>/api/auth/oidc/callback); APP_URL muss exakt der öffentlichen URL entsprechen; Signaturalgorithmus (RS256) und Scopes (openid email profile) prüfen
OIDC-Button fehlt (sso=nicht-konfiguriert)	Issuer, Client-ID und Client-Secret in Einstellungen → SSO prüfen
SSO-E-Mail wird abgelehnt	E-Mail muss im IdP verifiziert sein (email_verified: true); Details: SSO mit Authentik
Cron/Erinnerungen laufen nicht	CRON_SECRET gesetzt? Scheduler nutzt intern APP_INTERNAL_URL (Compose-Standard reicht); Test-Mail in den Einstellungen senden
DB-Schreibfehler (unable to open database)	Volume/Datei muss der UID 10001 gehören – bei manueller Wiederherstellung chown 10001:10001; Details: Backup und Restore
Port 3000 von außen erreichbar	Darf nicht sein: kein ports:-Mapping am App-Service; nur Caddy (80/443) ist außen erreichbar
Container startet, App antwortet nicht	docker inspect <container> --format='{{.State.Health.Status}}' prüfen (Healthcheck gegen /api/health); Logs: docker compose logs app
Nach Update fehlen Daten	Volumes prüfen (docker volume ls); kein docker compose down -v ohne Backup ausführen

Weiter: Deployment, Backup und Restore

Navigation

• Home
• Deployment
• SSO mit Authentik
• Haushalte und Rollen
• Backup und Restore
• Fehlerbehebung