Local Development¶

Start Services¶

docker compose up -d --build

Useful Commands¶

# Django checks
docker compose run --rm app python manage.py check

# Database migrations
docker compose run --rm app python manage.py migrate

# Open Django shell
docker compose run --rm app python manage.py shell

# Follow app logs
docker compose logs -f app

Daily Workflow¶

flowchart LR
    A[Pull latest changes] --> B[Rebuild if needed]
    B --> C[Run migrations]
    C --> D[Run checks and targeted tests]
    D --> E[Implement feature work]
    E --> F[Re-run tests and commit]

Recovery Commands¶

# Restart stack
docker compose down && docker compose up -d --build

# Re-run migrations
docker compose run --rm app python manage.py migrate

# Inspect application and worker logs
docker compose logs -f app celery

Stop Services¶

docker compose down

Notes¶

App source is bind-mounted from ./app.
Static data volume is mounted at /vol/web.
Database and redis data are persisted in Docker volumes.

For common runtime issues, use the Troubleshooting Matrix.