How toUpdated 2026-09-14

Run the local Site database

Available to developers

The local development substrate currently provides one Postgres 16 service for a Site. It binds to loopback on port 5432 and stores data in a named Docker volume.

Start Postgres

From the repository root:

docker compose up -d site-db

The development-only connection values are:

Setting	Value
Host	`127.0.0.1`
Port	`5432`
Database	`site`
User	`postgres`
Password	`postgres`

These values are local defaults, not production credentials.

Run the Site ingress service

In a second terminal:

cd site/backend
$env:SITE_DATABASE_URL = "postgresql://postgres:postgres@127.0.0.1:5432/site"
uv run uvicorn ingress.app:app --reload

Open http://127.0.0.1:8000/health. A reachable database returns HTTP 200 with status: ok; a failed database check returns HTTP 503 with status: error. See the health endpoint reference for the response shape.

Stop the service

From the repository root:

docker compose stop site-db

Stopping the container preserves its named volume. Removing local data is a separate, deliberate Docker operation and is not part of this guide.