Deploy Django / Django Rest Framework on Ubuntu 22.04 / 24.04

Today I'm gonna share how to Install and Configure Django / Django Rest Framework with Nginx and I am using AWS EC2 (t3.micro) for writing this tutorial.

Step 1 — Creating an EC2 Instance, DNS and SSH

First, we require an ec2 instance so launch an instance with your preferred size, you can also attach an Elastic IP to your instance.

In your DNS Server (Route 53 or Cloudflare) add these records.

Record NameRecord TypeValue

Now, we have pointed from our DNS to our new server IP, now we need to log in into our new server using SSH client.

Example: ssh -i "YourKey.pem" ubuntu@SERVER_IP

Step 2 — Setup and Installing Requirements

Set a Timezone on Ubuntu:

sudo timedatectl set-timezone Asia/Kolkata && sudo timedatectl

If first time using apt in this session, run the update command to update the package manager cache:

sudo apt update && sudo apt -y upgrade

Install Basic Requirements:

# Python 3.10
sudo apt install python3.10-venv -y && sudo apt install python3-pip -y && sudo apt install libpq-dev nginx curl

# Python 3.12
sudo apt install python3.12-venv -y && sudo apt install python3-pip -y && sudo apt install libpq-dev nginx curl

After installing, you can request to your domain (, You will get nginx default page as response.

Step 3 — Creating a Database (Optional)

If you are using any third party database like RDS then you can skip this step.

Create a Postgres database for Django application; so execute the following command on command line to create database for Django / DRF app:

Installing Requirements:

sudo apt install postgresql postgresql-contrib 
sudo -u postgres psql

Creating Database and User:

CREATE USER myprojectuser WITH PASSWORD 'password';
ALTER ROLE myprojectuser SET client_encoding TO 'utf8';
ALTER ROLE myprojectuser SET default_transaction_isolation TO 'read committed';
ALTER ROLE myprojectuser SET timezone TO 'UTC';
GRANT ALL PRIVILEGES ON DATABASE myproject TO myprojectuser;

Step 4 — Install and Configure Django Project

Creating a new Django project or Clone from Github/GitLab

You can set up the git into your server following this Link (OPTIONAL)

Generate SSH Key on Server:

ssh-keygen -o

cat /home/ubuntu/.ssh/ # Ubuntu 22.04

cat /home/ubuntu/.ssh/ # Ubuntu 24.04

Clone App from GitHub:

cd /home/ubuntu
git clone

Creating Virtual Environment and Setup Project Requirements:

cd drf-simple-task-tracker
python3 -m venv zenv
source zenv/bin/activate
pip install -r requirements.txt
python makemigrations
python migrate
python createsuperuser
python collectstatic

Make sure you have installed gunicorn and whitenoise in your env.

Testing Server:

python runserver

Request on

Step 5 — Setup Nginx & Gunicorn

You Can Generate All These Settings from Znas Tools


sudo nano /etc/systemd/system/gunicorn.socket

Paste Following:

Description=gunicorn socket




sudo nano /etc/systemd/system/gunicorn.service

Replace theproject directory and project.wsgi location as your project name:

Description=gunicorn daemon

ExecStart=/home/ubuntu/drf-simple-task-tracker/zenv/bin/gunicorn \
          --access-logfile - \
          --workers 3 \
          --timeout 600 \
          --bind unix:/run/gunicorn.sock \


Enable the Gunicorn:

sudo systemctl start gunicorn.socket
sudo systemctl enable gunicorn.socket
sudo systemctl status gunicorn.socket

Test Gunicorn:

sudo systemctl status gunicorn
curl --unix-socket /run/gunicorn.sock localhost
sudo systemctl status gunicorn

Setup Nginx File

Replace theproject name as your project:

sudo nano /etc/nginx/sites-available/project_name

Change the path/home/ubuntu/drf-simple-task-tracker and Copy, and paste the following Nginx Configuration:

server {
    client_max_body_size 100M;
    charset utf-8;
    underscores_in_headers on;

    # access_log /home/ubuntu/drf-simple-task-tracker/logs/nginx-access.log;
    error_log /home/ubuntu/drf-simple-task-tracker/logs/nginx-error.log;

    location = /favicon.ico { access_log off; log_not_found off; }
    location /static/ {
        alias /home/ubuntu/drf-simple-task-tracker/static/staticfiles/;
    location /media/ {
        root /home/ubuntu/drf-simple-task-tracker;
        client_max_body_size 100M;
    location / {
        include proxy_params;
        proxy_connect_timeout       600;
        proxy_send_timeout          600;
        proxy_read_timeout          600;
        send_timeout                600;    
        proxy_pass http://unix:/run/gunicorn.sock;

Enable the configuration:

sudo ln -s /etc/nginx/sites-available/project_name /etc/nginx/sites-enabled

sudo nginx -t
sudo systemctl restart nginx
sudo systemctl status nginx

Now you can request domain and your site should be visible.

Step 6 — Installing SSL

sudo apt install certbot python3-certbot-nginx

sudo certbot --nginx -d -d

sudo systemctl status certbot.timer
sudo certbot renew --dry-run

Now you can request the website using

Creating Shell Script (Quick Actions) [OPTIONAL]

For restarting the Nginx and pulling Code from Git, I have created a shell script.

sudo nano /usr/local/bin/z

For creating the shell script, modify copy, and paste the following code to your terminal.

select opt in Sync Restart ChangeDir CheckStatus Quit
    case $opt in
        cd /home/ubuntu/drf-simple-task-tracker
        git pull origin master
        echo "Code Synchronized!"
        exit 0
        sudo nginx -t && sudo systemctl restart nginx
        sudo systemctl restart gunicorn
        # sudo systemctl restart daphne.service # If Available
        echo "Nginx & gunicorn has been restarted."
        exit 0
        cd /home/ubuntu/drf-simple-task-tracker
        echo -e '\nHit [Ctrl]+[D] to exit this child shell.'
        exit 0
        echo "--> GUNICORN"    
        sudo systemctl status gunicorn
        echo "--> NGINX"    
        sudo systemctl status nginx
        echo "--> STORAGE"    
        df -h
        echo "--> Shell by SanjaySikdar.Dev <--"        
        exit 0
        echo "Exited!"
        exit 0
        echo "invalid option"
sudo chmod +x /usr/local/bin/z

Now press the z key and hit enter.

ubuntu@ip-172-31-0-94:~$ z
1) Sync
2) Restart
3) ChangeDir
4) CheckStatus
5) Quit

Select any option by pressing the number keys.

Hope you guys like the article. If you encounter any difficulties in understanding this approach, please don't hesitate to leave a comment.

Enabling The ASGI (Optional)

Bind the port 9001

daphne -b -p 9001 project.asgi:application

Create Daphne Service

sudo nano /etc/systemd/system/daphne.service
Description=daphne service

ExecStart=/home/ubuntu/drf-simple-task-tracker/zenv/bin/daphne -p 9001 project.asgi:application


Start Service

sudo systemctl daemon-reload
sudo systemctl start daphne.service
sudo systemctl status daphne.service
sudo systemctl enable daphne.service

Update Nginx File:

# Place Here
upstream channels-backend {
    server localhost:9001;
server {

    location / { }
    # Place Here
    location /ws/ {
        proxy_http_version 1.1;
        proxy_read_timeout 86400;
        proxy_redirect     off;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        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-Host $server_name;


sudo systemctl restart daphne.service


If nginx getting 403-Forbidden > sudo gpasswd -a www-data ubuntu

Other Permission Issue > sudo chmod +x /home/ubuntu/projectdir

Restart Deamon > sudo systemctl daemon-reload

Installing mysqlclient - Click here