Local Development

This guide covers running the development stack locally.

Prerequisites

• Docker + Docker Compose

Run

docker compose -f docker-compose.dev.yml up -d

URLs

• App: http://localhost:8080
• Admin UI (database): http://localhost:54323
• Mail catcher (dev): http://localhost:54324
• API gateway: http://localhost:8000

Notes

• The dev stack reads configuration from the repo root .env.
• First boot can take a few minutes while images pull and migrations run.