Skip to Content
DocumentationDeploymentOverview

Deployment Overview

Django-CFG supports multiple deployment strategies to fit your infrastructure needs.

🐳 Docker (Recommended)

Best for: Modern cloud deployments, microservices, consistent environments

Complete Docker deployment guide: Docker Setup Guide →

What’s Included

  • ✅ Development and production Docker Compose configurations
  • ✅ Multi-service architecture (Django, PostgreSQL, Redis, Workers)
  • ✅ Automated health checks and service dependencies
  • ✅ Configuration via YAML files and environment variables
  • ✅ Build optimization for minimal image sizes
  • ✅ Comprehensive troubleshooting guide

☁️ Cloud Platforms

AWS

  • ECS/Fargate: Container orchestration (use Docker setup)
  • Elastic Beanstalk: Platform-as-a-Service
  • EC2: Traditional virtual machines

Guide: Coming soon

Google Cloud

  • Cloud Run: Serverless containers (use Docker setup)
  • GKE: Kubernetes cluster
  • Compute Engine: Virtual machines

Guide: Coming soon

Azure

  • Azure Container Instances: Simple container deployment
  • AKS: Azure Kubernetes Service
  • App Service: Platform-as-a-Service

Guide: Coming soon

🚀 Traditional Deployment

VPS/Dedicated Servers

Requirements:

  • Python 3.12+
  • PostgreSQL 15+
  • Redis 7+
  • Nginx/Apache (reverse proxy)

Basic setup:

# Install Django-CFG
pip install django-cfg
 
# Configure settings
# See Configuration Guide for details
 
# Run with gunicorn
gunicorn api.wsgi:application
 
# Start ReArq workers
rearq main:rearq worker

Recommended guides:

🔧 Infrastructure Components

All deployment methods require:

Database

  • PostgreSQL - Primary database (recommended)
  • MySQL/MariaDB - Alternative option
  • SQLite - Development only

Database Configuration Guide →

Cache Layer

  • Redis - Recommended for caching and task queues
  • Memcached - Alternative caching backend

Cache Configuration Guide →

Background Tasks

  • ReArq - Built-in task processing
  • Celery - Alternative (requires additional setup)

ReArq Integration →

Reverse Proxy

  • Nginx - Recommended
  • Apache - Alternative
  • Traefik - For Docker deployments (included)

📋 Deployment Checklist

Before deploying to production:

Security

  • DEBUG = False in production
  • Strong SECRET_KEY (50+ characters)
  • Configure ALLOWED_HOSTS with actual domains
  • Enable HTTPS/SSL
  • Set up CORS properly via security_domains
  • Use environment variables for secrets

Security Settings Guide →

Configuration

  • Database connection configured
  • Redis/cache configured
  • Email service configured
  • Static files configured (Whitenoise or CDN)
  • Media files storage configured
  • Logging configured

Environment Setup Guide →

Monitoring

  • Health check endpoints configured
  • Logging to centralized service
  • Error tracking (Sentry, etc.)
  • Performance monitoring
  • Uptime monitoring

Monitoring Guide →

Backup & Recovery

  • Database backups automated
  • Media files backups
  • Backup restore tested
  • Disaster recovery plan

See Also

Docker Deployment

Configuration

Guides

TAGS: deployment, production, docker, cloud, infrastructure DEPENDS_ON: [django-cfg, docker, postgresql, redis] USED_BY: [production, ci-cd, devops]

FAQEnvironment Setup