Skip to content

Commit 6b45b97

Browse files
committed
docs(self-hosting): note that POSTGRES_* values must be URL-safe
docker-compose.prod.yml composes DATABASE_URL from them as written, so a value containing a URL delimiter initializes the database but breaks the connection string.
1 parent f2c1922 commit 6b45b97

1 file changed

Lines changed: 2 additions & 0 deletions

File tree

  • apps/docs/content/docs/platform/self-hosting

‎apps/docs/content/docs/platform/self-hosting/docker.mdx‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,8 @@ EOF
4343

4444
<Callout type="info">
4545
Do not set `DATABASE_URL` or `BETTER_AUTH_URL` in `.env` — `docker-compose.prod.yml` composes both on the service definition, and a value set here is ignored. Change `POSTGRES_*` and `NEXT_PUBLIC_APP_URL` instead.
46+
47+
Because `DATABASE_URL` is composed from them, keep `POSTGRES_USER`, `POSTGRES_PASSWORD`, and `POSTGRES_DB` URL-safe — letters, digits, and `.` `_` `~` `-`. They are inserted into the connection string as written, so a value containing `@`, `/`, `?`, `#`, `%`, or a space can initialize the database while leaving the app and migrations unable to connect. `openssl rand -hex` output is always safe.
4648
</Callout>
4749

4850
<Callout type="error">

0 commit comments

Comments
 (0)