# Deployment

## Development

```bash
cp .env.example .env
docker compose up --build
```

Services: `postgres`, `redis`, `qdrant`, `api` (:8000), `worker`, `web` (:3000).

## Production overlay

```bash
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d
```

The prod overlay swaps the API to Gunicorn + Uvicorn workers, drops dev bind
mounts and `--reload`, and adds a Caddy reverse proxy for automatic TLS. Provide
a `deploy/Caddyfile`.

Kubernetes manifests / Helm chart are a Phase 8 deliverable.

## Migrations

```bash
make migrate        # alembic upgrade head (inside apps/api)
```
