Docker Compose¶

Services¶

flowchart LR
    App[app]
    Worker[worker]
    Beat[beat]
    Redis[redis]
    App --> Redis
    Worker --> Redis
    Beat --> Redis
    App --> DB[(volume: db)]
    App --> Storage[(volume: storage)]
    Worker --> Storage

Service	Image / build	Purpose
app	Dockerfile	FastAPI + static
worker	Dockerfile	Celery worker
beat	Dockerfile	Celery Beat (backup, self-heal)
redis	redis:7-alpine	Broker, cache

Files¶

File	Purpose
`docker-compose.yml`	Local development
`docker-compose.prod.yml`	Production VPS
`Dockerfile`	Multi-stage build

Local run¶

cp .env.example .env
# Edit SECRET_KEY, AGE keys

docker compose up -d --build
docker compose logs -f app

Application: http://localhost:8000

Production¶

docker compose -f docker-compose.prod.yml up -d --build

Volumes¶

Volume	Path	Data
`./medinsight.db` or named	DB
`./storage`	Documents, DICOM
`./backups`	Archives

Warning

Do not delete volumes on docker compose down without a backup.

Variables in compose¶

Passed via env_file: .env or environment: in the compose file.

Build¶

Dockerfile optimized for VPS:

PIP_DEFAULT_TIMEOUT=300
PIP_RETRIES=5

Useful commands¶

# Rebuild one service
docker compose build app

# Shell in container
docker compose exec app bash

# Migrations
docker compose exec app python -m app.db.migrate

# Cleanup (without volumes)
./scripts/docker_cleanup.sh deploy

Healthcheck¶

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:8000/health/ready"]
  interval: 30s
  timeout: 10s
  retries: 3

Ports¶

Service	Host:Container
app	8000:8000
redis	6379 (internal)