Fehlerbehebung
Arbeite bei Störungen schrittweise: Erreichbarkeit, Containerstatus, Logs und Konfiguration. Verändere keine Datenvolumes, bevor du ein Backup und ein klares Fehlerbild hast.
StatO ist nicht erreichbar
- Prüfe, ob die verwendete Adresse und der Port stimmen.
- Prüfe den Containerstatus mit
docker compose ... ps. - Prüfe Firewall, Reverse Proxy und DNS, wenn StatO über das Netzwerk aufgerufen wird.
- Lies die letzten Logs des Frontend- und Backend-Containers.
Frontend lädt, aber die API antwortet nicht
Prüfe, ob Backend und Datenbank laufen. In der Standard-On-Premises-Architektur spricht das Frontend intern mit dem Backend. Direkte externe Backend-Ports sind normalerweise nicht erforderlich.
Login, Einladungen oder Reset-Links führen zur falschen Adresse
Prüfe die öffentlichen URL-Werte wie APP_ORIGIN. Sie müssen exakt zur Adresse passen, über die Benutzer:innen StatO aufrufen – einschließlich http oder https und gegebenenfalls Port.
Uploads fehlen nach einem Neustart
Prüfe die persistenten Volumes und ihre Berechtigungen. Daten, die nur im Container-Dateisystem liegen, sind nach einer Neuerstellung nicht dauerhaft verfügbar.
Backend startet nicht
Lies die Backend-Logs. Häufige Ursachen sind fehlende oder ungültige Konfigurationswerte, nicht erreichbare Datenbank, falsche SMTP-Konfiguration bei aktivierter Zwei-Faktor-Anmeldung oder ein zu schwaches Superadmin-Passwort beim Erststart.
Noch keine Lösung?
Sichere die relevante Fehlermeldung, StatO-Version, Betriebssystem, die anonymisierte Konfiguration und die bereits durchgeführten Schritte. Teile niemals Passwörter, Tokens oder die vollständige stato.env ungeschützt.