Deployment Guide

upstream frontend {
    server frontend:3000;
}
 
upstream backend {
    server backend:8000;
}
 
server {
    listen 443 ssl http2;
    server_name eneo.example.com;
 
    ssl_certificate /etc/nginx/ssl/cert.pem;
    ssl_certificate_key /etc/nginx/ssl/key.pem;
 
    # API routes to backend
    location /api/ {
        proxy_pass http://backend;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
 
        # WebSocket support
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
 
    location /docs {
        proxy_pass http://backend;
        proxy_set_header Host $host;
    }
 
    location /openapi.json {
        proxy_pass http://backend;
    }
 
    location /version {
        proxy_pass http://backend;
    }
 
    # Everything else to frontend
    location / {
        proxy_pass http://frontend;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

ENEO_SUPER_API_KEY=your-secure-api-key

ENEO_SUPER_DUPER_API_KEY=your-other-secure-api-key

# In env_backend.env
LOGLEVEL=DEBUG

docker compose restart backend
docker compose logs -f backend

# Check all services are running
docker compose ps
 
# Test backend API
curl https://your-domain.com/api/health
 
# Check database
docker compose exec db psql -U eneo -c "SELECT version()"
 
# Check Redis
docker compose exec redis redis-cli ping
 
# View db-init logs (for first-run issues)
docker logs eneo_db_init

# All services
docker compose logs -f
 
# Specific service
docker compose logs -f backend
 
# Last 100 lines
docker compose logs --tail=100 backend worker

# Default (not recommended for production)
frontend:
  image: ghcr.io/eneo-ai/eneo-frontend:latest
 
# Production (pin to specific version)
frontend:
  image: ghcr.io/eneo-ai/eneo-frontend:v1.2.3
backend:
  image: ghcr.io/eneo-ai/eneo-backend:v1.2.3
worker:
  image: ghcr.io/eneo-ai/eneo-backend:v1.2.3

# Create timestamped database backup
docker compose exec -T db pg_dump -U eneo eneo | gzip > backup_$(date +%Y%m%d_%H%M%S).sql.gz
 
# Restore from backup (if needed)
gunzip -c backup_20250108.sql.gz | docker compose exec -T db psql -U eneo eneo

# Stop services first
docker compose down
 
# Backup PostgreSQL data volume
docker run --rm -v eneo_postgres_data:/data -v $(pwd):/backup ubuntu \
  tar czf /backup/postgres_volume_$(date +%Y%m%d).tar.gz /data
 
# Backup Redis data volume (optional)
docker run --rm -v eneo_redis_data:/data -v $(pwd):/backup ubuntu \
  tar czf /backup/redis_volume_$(date +%Y%m%d).tar.gz /data

# Scale backend instances (with load balancer)
docker compose up -d --scale backend=3 --scale worker=2