Running Locally
How to bring the AT1AS v2 server up on your machine with Docker Compose. This gets you a Postgres database and the Rust API running side by side.
Quick start
From the repository root:
cd v2 && docker compose up -d --build
This brings up two services:
| Service | Port | Notes |
|---|---|---|
| PostgreSQL | 5433 (host) | the source of truth; mapped off the default 5432 to avoid clashing with a local Postgres |
| API (Rust / Axum) | 8080 | the REST + WebSocket surface |
Migrations
Database migrations auto-load on startup — the API applies them against Postgres when the container comes up, so there's no separate migrate step. A fresh database is seeded and ready once the API reports healthy.
Health check
Confirm the stack is up by hitting the health endpoint:
curl http://127.0.0.1:8080/healthz
# → { "ok": true, "db": true }
Use
127.0.0.1, notlocalhost—localhostcan resolve to IPv6::1and hang.
db: true confirms the API reached Postgres. Once you see that, you can register an account and start exercising the API.