Docker Development Setup

# Navigate to docker directory
cd docker
 
# Start all services
docker compose up -d
 
# Check status
docker compose ps
 
# View logs
docker compose logs -f

docker/
├── docker-compose.yaml              # Main compose file
├── .env                            # Environment variables
├── .dockerignore                   # Build context exclusions
│
├── services/                        # Service-specific configs
│   ├── django/
│   │   ├── Dockerfile              # Django application
│   │   ├── entrypoint.sh          # Container startup
│   │   ├── config.dev.ignore.yaml # Dev API keys (in git!)
│   │   └── config.prod.ignore.yaml# Prod API keys (in git!)
│   ├── demo/Dockerfile            # Next.js demo app
│   ├── websocket/Dockerfile       # WebSocket RPC server
│   ├── web/Dockerfile             # Nuxt.js docs site
│   └── postgres/init.sql          # DB initialization
│
├── volumes/                         # Persistent data (git-ignored)
│   ├── postgres/                  # Database files
│   ├── django/media/              # User uploads
│   └── django/logs/               # Application logs
│
└── @docs/                           # Documentation
    ├── README.md                   # Complete reference
    ├── CONFIG_STRATEGY.md         # Configuration guide
    ├── DOCKER_BUILD_LESSONS.md    # Build optimization
    └── QUICK_REFERENCE.md         # Command reference

postgres:
  image: pgvector/pgvector:pg15
  environment:
    POSTGRES_DB: djangocfg
    POSTGRES_USER: postgres
    POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U postgres -d djangocfg"]
    interval: 10s

DATABASE_URL=postgresql://postgres:password@postgres:5432/djangocfg

redis:
  image: redis:7-alpine
  command: >
    redis-server
    --maxmemory 512mb
    --maxmemory-policy allkeys-lru
    --databases 3

REDIS_URL=redis://redis:6379/0
REDIS_REARQ_URL=redis://redis:6379/1

django:
  build:
    context: ..
    dockerfile: docker/services/django/Dockerfile
  environment:
    DJANGO_SETTINGS_MODULE: api.settings
    DATABASE_URL: postgresql://postgres:${POSTGRES_PASSWORD}@postgres:5432/djangocfg
    REDIS_URL: redis://redis:6379/0
  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:8000/cfg/health/"]
    interval: 30s

django-rearq:
  image: djangocfg-django:latest
  environment:
    SKIP_MIGRATIONS: "true"
    REARQ_WORKERS: 2
  command: ["/entrypoint.sh", "rearq", "main:rearq", "worker"]
  depends_on:
    django:
      condition: service_healthy

websocket:
  environment:
    WS_HOST: 0.0.0.0
    WS_PORT: 9065
    HEALTH_PORT: 9066
    REDIS_URL: redis://redis:6379/2
    JWT_SECRET: ${JWT_SECRET}

# Run migrations
docker exec django python manage.py migrate
 
# Create superuser
docker exec -it django python manage.py createsuperuser
 
# Django shell
docker exec -it django python manage.py shell
 
# Collect static files (if needed)
docker exec django python manage.py collectstatic --noinput
 
# Custom management command
docker exec django python manage.py your_command

# Access PostgreSQL shell
docker exec -it djangocfg_postgres psql -U postgres -d djangocfg
 
# Run SQL query
docker exec djangocfg_postgres psql -U postgres -d djangocfg -c "SELECT * FROM django_migrations LIMIT 5;"
 
# Backup database
docker exec djangocfg_postgres pg_dump -U postgres djangocfg > backup.sql
 
# Restore database
docker exec -i djangocfg_postgres psql -U postgres djangocfg < backup.sql
 
# Reset database (⚠️ DESTRUCTIVE)
docker exec djangocfg_postgres psql -U postgres -c "DROP DATABASE djangocfg;"
docker exec djangocfg_postgres psql -U postgres -c "CREATE DATABASE djangocfg;"
docker exec django python manage.py migrate

# All services
docker compose logs -f
 
# Specific service
docker compose logs -f django
 
# Last 50 lines
docker compose logs --tail=50 django
 
# With timestamps
docker compose logs -f --timestamps django

# Restart single service
docker compose restart django
 
# Stop all services
docker compose stop
 
# Start all services
docker compose start
 
# Remove all services (keeps volumes)
docker compose down
 
# Remove all including volumes (⚠️ DELETES DATA)
docker compose down -v

# Rebuild single service
docker compose build django --no-cache
docker compose up -d django
 
# Rebuild all services
docker compose build --no-cache
docker compose up -d
 
# Force recreate containers
docker compose up -d --force-recreate

# Database
POSTGRES_DB=djangocfg
POSTGRES_USER=postgres
POSTGRES_PASSWORD=your_password_here
 
# Django
DJANGO_SECRET_KEY=your-secret-key-here
DJANGO_DEBUG=true
 
# ReArq
REARQ_WORKERS=2
 
# API Keys (optional)
ANTHROPIC_API_KEY=sk-ant-your-key
OPENAI_API_KEY=sk-proj-your-key
 
# JWT
JWT_SECRET_KEY=your-jwt-secret-here

# docker/services/django/config.dev.ignore.yaml
api_keys:
  openai: "sk-proj-your-team-key"
  anthropic: "sk-ant-your-team-key"
 
email:
  backend: "smtp"
  host: "mail.example.com"
  username: "[email protected]"
  password: "smtp-password"

docker compose logs django
docker compose ps

docker exec django python -c "from api.environment.loader import env; print(env.env.env_mode)"
# Should output: development

docker exec django ls -la /app/api/environment/

docker compose ps djangocfg_postgres
docker exec djangocfg_postgres pg_isready -U postgres

docker exec django python manage.py check --database default

lsof -i :8300

kill -9 <PID>

ports:
  - "8301:8000"  # Changed from 8300

sudo chown -R $USER:$USER docker/volumes/

# Increase workers
REARQ_WORKERS=4
 
# Increase Redis memory
redis:
  command: redis-server --maxmemory 1gb