Building a Scalable Django Application with Gunicorn and Nginx

• Scaling your web app is essential for success.
• Django is great, but Gunicorn and Nginx are needed for true scalability.
• This post shows you how to build a scalable Django app with Gunicorn and Nginx.
• This post follows in "Kali Linux". You can use any Linux based OS.

Introduction:

• Building a web application that can handle a growing number of users and requests is crucial for any successful project.
• Django, a powerful Python framework, provides a solid foundation, but for true scalability, you need to leverage the power of tools like Gunicorn and Nginx.
• This post will guide you through the process of setting up a scalable Django application using Gunicorn and Nginx, ensuring your website can handle the demands of a growing user base.

⚙️ Setting up -

• I am doing this in Linux.
• First check python3, pip, nginx Installed or not.
• To install use this command (install in home/Desktop or new terminal)

sudo apt install python3 python3-pip nginx 

• Now create a Virtual environment (create new folder 📂 for this)
• Activate the environment

source environment_name/bin/activate   # use name created above "environment_name"

• Now Install packages 📦 in environment
  • django, gunicorn

pip install django
pip install gunicorn

// or directly install both
pip install django gunicorn

Creating Django Project

• Use this command to create Django project

django-admin startproject myproject      # use any name "myproject"

Create a Gunicorn Configuration File

• Use this command

nano gunicorn_conf.py  # use any name but using same better "gunicorn_conf.py"

• Add the following code in "gunicorn_config.py"

import multiprocessing

bind = '127.0.0.1:8000' # Django running port/link
workers = multiprocessing.cpu_count() * 2 + 1

• Save file using "CTRL + o"(to save), press ENTER, "CTRL + X"(to exit)
• This will create workers and also we should add our Django running link. ### Run the Django project/application with gunicorn
• First navigate to project folder

cd myproject   # navigate to Django Project "myproject"

• Now run this command

gunicorn myapp.wsgi:application -c ../gunicorn_conf.py  # here myapp is myproject

# here "myapp" is a Django project name, and at last gunicorn_conf.py is a gunicorn configuration file which created above/before.

• Now make some changes in Django project
• First change some code in settings.py in project folder. Directory myproject/myproject/settings.py > Django project
• For this use any code editor like VS Code. To open from terminal use this command

code- oss

# to open vs code from terminal

• Add this code

# example code
ALLOWED_HOSTS = ['localhost', '0.0.0.0', '127.0.0.1'] # use IP address here

• In above command we used IP address, to get that open another new terminal and run this command to get all about network.

ifconfig

Create a Nginx Configuration File

• Open another new terminal, run this command

sudo nano /etc/nginx/sites-available/myapp       # use any name "myapp"

# better use vs code instead of nano
sudo code- oss /etc/nginx/sites-available/myapp   # check code-oss

• Add code in that nginx file

server {
    listen 80;
    server_name your_domain.com;  # Replace with your domain or IP address
    # example for aboveline: server_name 'ipaddress' 'another domain' ;

    location / {
        proxy_pass http://127.0.0.1:8000;  # Gunicorn's default address
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

• save the file
• create a Symbolic Link to enable Nginx Configuration, run this command

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

# change "myapp" to nginx config file name used above

• That's it. ## Testing:
• First check Nginx configuration file for any syntax error.

sudo nginx -t

• If you don't have any errors, first restart the Nginx using this command

sudo systemctl restart nginx

Setting up Firewall for Nginx

• Open new terminal, and install this package

sudo apt install ufw

• Now allow Nginx through Firewall

sudo ufw allow 'Nginx Full'

Using Instructions -

• First start Nginx by opening new terminal

sudo systemctl start nginx

• Now to start complete project open a terminal and go to virtualenv created and activate

gunicorn myapp.wsgi:application -c ../gunicorn_conf.py

# in above code "myapp" is a Django project name
# last gunicorn_conf.py is a gunicorn configuration file name

• Now the complete project started.
• Now you can open your django project with your IP address.
• Navigate to browser and search with your IP address.
• To stop Nginx, use this command

sudo systemctl stop nginx

Happy Coding 😴 - Be Lazy

Contact DM - Twitter(X)
Contact Mail - [e-mail]