Help

Troubleshooting (self-hosted)

Fix common self-hosted SlugBase install and runtime problems: secrets, URLs, database, proxy, and first-run issues.

Before you dig in

Most production failures come from environment variables or URL mismatch behind a reverse proxy. Confirm values with Configuration and Reverse proxy and HTTPS. For a clean first install, follow First run setup.

Check container or process logs when the server exits immediately or API calls fail—startup validation prints clear errors for missing or weak secrets.

Server exits on startup

Database and data

OIDC and email

Slugs and `/go/` links

API documentation and health checks

FAQ

Quick answers with links back into these guides.

Docker Compose

Volumes, env files, and typical compose pitfalls.

Was this page helpful?

Last updated 3 days ago

Built with Documentation.AI