!reset tags.
1
Provision the database
Have the database administrator create an empty
spicedb database owned by a dedicated login. Confirm that
the Compose host can reach it privately. Keep the login’s password for the connection URI; do not configure
POSTGRES_ADMIN_URL or run the bundled bootstrap job.2
Select the external Compose mode
This override is a newer deployment asset; older release tags may not contain it. Use a target that
ships it, and download it from the same tag as the base Compose file. Do not combine an old base
file with today’s override. For a fresh install following
stable, use stable for both files.
Keep the base file and your existing application database settings. In .env, remove
AUTHZED_DATABASE_PASSWORD and add these lines, replacing the host and percent-encoded password:COMPOSE_FILE makes every docker compose command in this guide use the override. Keep it in .env for
future updates. If you pass -f explicitly, pass both files in the same order for every command instead.
Protect .env with mode 0600; do not paste its rendered configuration into logs or tickets.3
Configure a private CA if needed
If PostgreSQL uses a private CA, add Merge these
&sslrootcert=/certs/ca.pem to the URI and mount the same CA file into
both services in the external override:volumes entries into the downloaded override; keep its !reset and environment entries.
sslmode=verify-full checks the server certificate against the hostname in the URI.4
Validate and start
Run
docker compose config --quiet before starting services. Fresh installs can then use docker compose up -d; existing installations
must follow the maintenance procedure first. Check docker compose config --services:
it must omit authzed-db-bootstrap. After startup, docker compose ps -a should show
spicedb-migrate completed and spicedb healthy. A failed migration prevents SpiceDB from starting.The one-click installer continues to use bundled PostgreSQL. Changing an existing v6 SpiceDB datastore from
bundled to external PostgreSQL also requires a separate data migration; this override does not copy data.