Back to all templates
Django logo

Django

Development512MB+ RAM

Production-ready Django application with PostgreSQL and Gunicorn

developmentframeworksdjangoopen-sourceself-hosteddocker

Deploy Django in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Django

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Manual Setup Guide

Set Up Django from Terminal

Get your hands dirty: manual Django deployment guide for developers.

1

Access Your VPS Terminal

Use your terminal to securely access your server. You'll need your server's IP address.

terminal
# Connect via SSH
ssh root@your-vps-ip

# Alternative with key file
ssh -i /path/to/key root@your-vps-ip

First time? Make sure Docker is installed on your VPS. Run: curl -fsSL https://get.docker.com | sh

2

Set Up the Deployment Folder

Initialize a project folder on your server.

terminal
# Create and navigate to project directory
mkdir -p ~/apps/django
cd ~/apps/django
3

Set Up the Stack Definition

Use this Docker Compose configuration for your deployment:

docker-compose.yml
services:
  django:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8000:8000"
    environment:
      - DJANGO_SETTINGS_MODULE=config.settings
      - WSGI_APPLICATION=config.wsgi:application
      - SECRET_KEY=<your-secret-key>
      - DATABASE_URL=postgresql://django:<your-db-password>@db:5432/django_db
      - ALLOWED_HOSTS=*
      - DEBUG=False
    volumes:
      - static_volume:/app/staticfiles
      - media_volume:/app/media
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy

  db:
    image: postgres:16-alpine
    environment:
      - POSTGRES_DB=django_db
      - POSTGRES_USER=django
      - POSTGRES_PASSWORD=<your-db-password>
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U django -d django_db"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  postgres_data:
  static_volume:
  media_volume:
Environment Variables
PORTDjango application port(default: 8000)
SECRET_KEYDjango secret key
DB_NAMEDatabase name(default: django_db)
DB_USERDatabase user(default: django)
DB_PASSWORDDatabase password
DJANGO_SETTINGS_MODULESettings module(default: config.settings)
4

Start the Containers

Bring up your containers in detached mode.

terminal
# Start all services
docker compose up -d

# List running containers
docker compose ps

# Watch the logs
docker compose logs -f
5

Set Up Firewall Rules

Allow the application port through your server's firewall.

terminal
# Allow the application port through firewall
sudo ufw allow 8000/tcp
sudo ufw reload

# Access your app at:
# http://your-server-ip:8000
Skip the Terminal

Let Server Compass do the heavy lifting.

Why type commands when you can click? Deploy Django the easy way with Server Compass.

  • Beautiful interface
  • One-click deploys
  • Let's Encrypt SSL
  • Zero downtime
  • Container monitoring
  • Easy rollbacks
Download Server Compass$29 one-time • Lifetime license

After Deployment

After deploying Django with Server Compass, complete these steps to finish setup

1

Run migrations: docker exec <container> python manage.py migrate

2

Create superuser account

Need help? Check out our documentation for detailed guides.

Django FAQ

Common questions about self-hosting Django

How do I deploy Django with Server Compass?

Simply download Server Compass, connect to your VPS, and select Django from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Django?

Django requires a minimum of 512MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Django data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Django backup and restore procedures.

How do I update Django to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Django image will be pulled and deployed with zero downtime.

Is Django free to self-host?

Django is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host Django?

Download Server Compass and deploy Django to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass