Troubleshooting
Häufige Fehler bei Install und Deploy — und wie du sie selbst löst.
API crasht beim Start: BETTER_AUTH_SECRET
Fix: BETTER_AUTH_SECRET auf 32+ Zufalls-Bytes setzen. Generieren mit openssl rand -hex 32. Die API wirft absichtlich, statt mit schlechtem Default zu laufen — siehe Env-Vars-Referenz.
CORS-Fehler im Browser
Fix: Frontend-Origin zu TRUSTED_ORIGINS_EXTRA hinzufügen. PUBLIC_URL ist automatisch in der Trusted-Liste — diese Var ist nur für Extras (Staging, eigene Preview-Domains).
Bridge-Iframe bleibt leer im Admin-Preview
Fix: customParent der Bridge auf deinen Admin-Origin setzen. Die Storyblok-Bridge nimmt per Default app.storyblok.com an und verwirft alle postMessages von einem anderen Parent. Siehe Features → MCP-Seite für den kanonischen Plugin-Snippet.
Upload liefert 403
OIDC-Login springt zurück auf /login
Fix: Redirect-URI beim IdP exakt auf PUBLIC_URL + '/api/auth/callback/<provider-id>' setzen. Jede Abweichung — Trailing-Slash, http vs https, falscher Port — und der IdP redirected zurück ohne Session.