Local Docker Deployment

Run the supported local service stack for evaluation and integration testing.

The supported local Docker stack runs Gateway, Web, Identity, PostgreSQL, Redis, and object storage together. The older single-image SQLite profile has been retired because the current Gateway requires PostgreSQL.

Start the Minimal Profile

From a checked-out repository:

bash
bun run docker:up

The gateway listens on http://127.0.0.1:8877. Wait for the container health check before sending requests.

Health Checks

bash
curl http://127.0.0.1:8877/healthz
curl http://127.0.0.1:8877/readyz

Data and Credentials

  • PostgreSQL, Redis, and object-storage data persist in named Docker volumes.
  • The example compose file contains development-only bootstrap credentials.
  • Replace every bootstrap secret before sharing the environment.
  • Do not expose this profile directly to the public internet.

Production Boundary

The minimal profile is not the production topology. Production deployment requires external PostgreSQL, Redis, managed secrets, object storage, dedicated Web and Identity services, TLS ingress, migrations, backups, and rollback evidence. Contact support before planning a self-hosted production rollout.

Stop the profile without deleting its volume:

bash
bun run docker:down