How to deploy Python framework application using uwsgi in Ubuntu 18.04



In this blog we learn to deploy a python based frameworks deployment on ubuntu 18.04 server and how to setup nginx and uwsgi application on the server. We will launch the application and configure the front-end of nginx server and back-end for the uwsgi.


Lets started the blog you have to setup some pre-installation:

  • Login to the server and user will be non-root user with sudo privileges
  • Step 1 is installed and configure nginx on ubuntu server.
  • In next step we want a domain because uwsgi is required a domain name for running the application.

Step 1: Install the components and setup the environment for the project:

In this step you have to setup the git repository. Then we will have to install Python3 pip, package to setup the python package manager. After that start python development files necessary to build uWSGI.

First local package update, index and install the packages that will allow to build our python environment.


sudo apt update

sudo apt install python3-pip python3-dev build-essential libssl-dev libffi-dev python3-setuptools

python3 -m pip install –user –upgrade pip

Step 2: After that install and create python environment of the python according to the version of the python. Now we are using python 3.


sudo apt install python3-venv

python3.6 -m venv env

Note: You can change your environment name.

Step 3: Create a folder for the project and inside it create an environment and then activate the python environment.


source env/bin/activate

Step 4: Now setup the environment and install uwsgi of the application.


pip install wheel

pip install uwsgi

sudo -H pip3 install uwsgi

sudo apt install uwsgi-plugin-python

sudo apt-get install libpcre3 libpcre3-dev

Step 5: After the installation of the uwsgi test it.


uwsgi –http :8000 –home /home/workstation/env(path of environment) –chdir /home//workstation/app-source_code/(path of python code) -w source_code.wsgi(name of uwsgi application)

Step 6: Setup the files and configuration of the uwsgi.

Create a directory for uwsgi configuration file.


sudo mkdir -p /etc/uwsgi/sites

sudo mkdir -p /var/log/uwsgi-logs

sudo nano /etc/uwsgi/sites/source-code.ini

code of the project-name .ini file


uid = ubuntu

gid = ubuntu

chdir = /home/workstation/app-source_code/

home = /home//workstation/env

module = source-code.wsgi:application

#env = DJANGO_SETTINGS_MODULE=movies.settings

master = true

processes = 5

socket = /run/uwsgi/project-name.sock

logto = /var/log/uwsgi-logs/uwsgi.log

chown-socket = ubuntu:www-data

chmod-socket = 660

vacuum = true

Step 7: createa system file of the uwsgi.


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

Copy the code inside the file


Description=uWSGI Emperor service


ExecStartPre=/bin/bash -c ‘mkdir -p /run/uwsgi; chown ubuntu:www-data /run/uwsgi’

ExecStart=/usr/local/bin/uwsgi –emperor /etc/uwsgi/sites






Step 8: After that check the uwsgi is running fine or not.


sudo systemctl status uwsgi.service

Step 9: Now install the nginx server and configure the config files of the nginx for the uwsgi application.


sudo apt update

sudo apt upgrade

sudo apt install nginx

Step 10: After that go to the path and create a config file of the uwsgi application.


cd /etc/nginx/sites-available

nano uwsgi-application

Copy the code to the file

server {

server_name (domain-name).com www.(domain name).com;

#server_name localhost;

location = /favicon.ico { access_log off; log_not_found off; }

location / {

include uwsgi_params;

uwsgi_pass unix:/run/uwsgi/(uwsgi name).sock;


location /static {

root /home/workstation/app-source_code/;



Step 11: Create a soft-link of the config files of nginx serve the uwsgi application.


sudo ln -s /etc/nginx/sites-available/uwsgi-application  /etc/nginx/sites-enabled

Step 12: After that complete the configuration of the nginx configurations test the changes correct or not. 


sudo nginx -t

Step 13: Then reload or restart the nginx server.


sudo systemctl restart nginx

Step 14: Then daemon and uwsgi restart.


sudo systemctl daemon-reload

sudo systemctl restart uwsgi

Step 15: To enable both of the services to start automatically at boot.


sudo systemctl enable nginx

sudo systemctl enable uwsgi

Conclusion: Deployment Complete. You can check the url of uwsgi application servers and it will be accessible on web browsers.

Leave a Reply