docker-compose

Docker Compose Development Environment

context7: If the mcp_context7 tool is available, resolve and load the full Docker Compose documentation before modifying compose.yaml or using advanced CLI options:

mcp_context7_resolve-library-id: "docker compose"
mcp_context7_get-library-docs: /docker/compose

The development environment runs entirely through Docker Compose. All services are defined in compose.yaml.

---

Services

{%- if cookiecutter.include_fastapi == "y" %} | www | FastAPI application server | {%- endif %} {%- if cookiecutter.include_celery == "y" %} | celery-scheduler | Celery Beat scheduler for periodic tasks | | celery-node | Celery worker for background tasks | {%- endif %} {%- if cookiecutter.include_quasiqueue == "y" %} | qq | QuasiQueue multiprocessing runner | {%- endif %} {%- if cookiecutter.include_sqlalchemy == "y" %} | db | PostgreSQL database | {%- endif %} {%- if cookiecutter.include_celery == "y" or cookiecutter.include_aiocache == "y" %} | redis | Redis cache / task broker | {%- endif %}

---

Essential Commands

Start / Stop

# Start all services in the background
docker compose up -d

# Start with live rebuild on file changes
docker compose up --watch

# Stop all services (preserves volumes — data is retained)
docker compose down

# Stop all services AND remove volumes (full reset — destroys all data)
docker compose down --volumes --remove-orphans

# Restart all services without destroying containers or volumes
docker compose restart

# Restart a single service
docker compose restart www

Logs

# View recent logs from all services
docker compose logs

# Follow (tail) logs from all services in real-time
docker compose logs -f

# Follow logs from a specific service
docker compose logs -f www

Status and Inspection

# List running services and their status
docker compose ps

# Open a bash shell inside a running service
docker compose exec www bash