Minimal Docker Deployment

Run the local single-image gateway profile for evaluation and integration testing.

The repository's single-image profile packages the gateway runtime and Enterprise static assets with a local SQLite data volume. It is intended for evaluation and integration testing on one machine.

Start the Minimal Profile

From a checked-out repository:

bash
bun run docker:build:minimal
docker compose -f devops/docker-compose.minimal.yml up -d

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

  • SQLite data persists in the named Docker volume.
  • 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
docker compose -f devops/docker-compose.minimal.yml down