How to Deploy a Django App with uWSGI, Nginx, and HTTPS – Step‑by‑Step Guide

Create a Django project

Start a new Django project named django_deployment and allow external hosts. django-admin startproject django_deployment In settings.py set:

ALLOWED_HOSTS = ["*"]

Run a simple uWSGI application with a Python file

def application(env, start_response):
    start_response('200 OK', [('Content-type', 'text/html')])
    return [b'Hello uWSGI.']

Start it with:

uwsgi --http-socket :8000 --plugin python3 --wsgi-file uwsgi_test.py

If uWSGI is not installed, install the required plugins:

sudo apt install uwsgi-plugin-common
sudo apt install uwsgi-plugin-python3

Configure uWSGI for the Django project

Create django-uwsgi.ini with the following content:

[uwsgi]
chdir = /source/python/deployment/django_deployment
module = django_deployment.wsgi
http-socket = :8000
master = True
processes = 4
threads = 1
vacuum = true

Start uWSGI using the ini file:

uwsgi --ini django-uwsgi.ini

Set up Nginx as a reverse proxy

Backup the existing nginx.conf and edit it to add an upstream and server block:

upstream uwsgi {
    server 122.51.1.19:8000;
}
server {
    listen 80;
    server_name 122.51.1.19;
    charset utf-8;
    location / {
        proxy_pass http://uwsgi;
    }
}

Reload Nginx:

nginx -s reload

Collect static files

In settings.py add: STATIC_ROOT = os.path.join(BASE_DIR, 'static') Then run: python manage.py collectstatic Update the Nginx server block to serve the static directory:

location /static {
    alias /source/python/deployment/django_deployment/static;
}

Enable HTTPS

Obtain an SSL certificate and copy .crt and .key files to /etc/nginx/ssl. Add an HTTPS server block:

listen 443 ssl;
ssl_certificate /etc/nginx/ssl/domain.com.crt;
ssl_certificate_key /etc/nginx/ssl/domain.com.key;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;

Redirect HTTP to HTTPS:

server {
    listen 80;
    server_name topic.akashi.org.cn;
    return 301 https://$host$request_uri;
}

Reload Nginx again:

nginx -s reload

High‑availability configuration

Define multiple uWSGI back‑ends with weights for load balancing:

upstream uwsgi {
    server 127.0.0.1:8000 weight=3;
    server 127.0.0.1:8001 weight=1;
}

Do not run uWSGI as root and disable external access to the uWSGI socket.

Monitoring and management

Check running processes:

ps -aux | grep uwsgi
ps -aux | grep nginx

View logs: tail -f /var/log/nginx/nginx.log Stop uWSGI gracefully using the PID file: uwsgi --stop /path/to/uwsgi-8000.pid All commands are shown without additional styling to keep the HTML clean and focused on the core deployment steps.