Docker Guide¶

Local Development Setup¶

Prerequisites¶

Docker
Docker Compose
Make (optional)

Start Services¶

# Start all services
docker-compose up -d

# Start specific service
docker-compose up -d backend

# View logs
docker-compose logs -f backend

Stop Services¶

# Stop all services
docker-compose down

# Stop and remove volumes (CLEAN slate)
docker-compose down -v

Services¶

Service	Port	Description
backend	8000	FastAPI application
postgres	5432	PostgreSQL database
docs	8001	Documentation site (mkdocs)

Environment Variables¶

# Copy example env
cp .env.example .env

# Edit with your values
DATABASE_URL=postgresql://user:pass@localhost:5432/saas_courier

Database Commands¶

# Connect to PostgreSQL
docker-compose exec postgres psql -U postgres -d saas_courier

# Run migrations
docker-compose exec backend alembic upgrade head

# Seed database
docker-compose exec backend python scripts/seed.py

Rebuild Services¶

# Rebuild without cache
docker-compose build --no-cache

# Recreate services
docker-compose up -d --force-recreate