{"id":2655,"date":"2018-10-05T21:00:11","date_gmt":"2018-10-05T15:30:11","guid":{"rendered":"https:\/\/pheonixsolutions.com\/blog\/?p=2655"},"modified":"2019-04-05T18:07:57","modified_gmt":"2019-04-05T12:37:57","slug":"setting-up-django-and-your-web-server-with-uwsgi-and-nginx-on-ubuntu","status":"publish","type":"post","link":"https:\/\/pheonixsolutions.com\/blog\/setting-up-django-and-your-web-server-with-uwsgi-and-nginx-on-ubuntu\/","title":{"rendered":"Setting up Django and your web server with uWSGI and nginx on Ubuntu"},"content":{"rendered":"

Setting up Django and your web server with uWSGI and nginx<\/h2>\n

Date posted: 05-oct-2018<\/strong><\/p>\n

\u00a0<\/p>\n

In this article, we will see how to setup a Django web application on Ubuntu 16.04 server. We’ll use UWSGIservice to deploy our webapp along with Nginx.<\/p>\n

Requirements:-<\/h4>\n

Python 3.6<\/p>\n

Django\u00a02.0.7<\/p>\n

Nginx\u00a01.10.3<\/p>\n

Ubuntu 16.04<\/p>\n

Install Python basic packages<\/h4>\n

sudo apt-get install python3-dev\u00a0\u00a0python3-pip\u00a0<\/code><\/p>\n

sudo apt-get install python3-setuptools<\/code><\/p>\n

sudo apt-get install python3-kivy<\/code><\/p>\n

Install Virutal Environment<\/h4>\n

pip3 install virtualenv virtualenvwrapper<\/code><\/code><\/p>\n

Install Django<\/h4>\n

pip3 install django<\/code><\/p>\n

Install UWSGI<\/h4>\n

sudo pip install uwsgi<\/code><\/h4>\n

Now we need to create the vassals folder, which is the folder where our .ini<\/code> files (called vassals<\/code>) will reside upon. Inside vassals we will have two other folders: available<\/code> and enabled<\/code>. The first will contain all the (.ini) configuration files. While the second (enabled<\/code>) will contain a symlink to the files at available<\/code><\/p>\n

cd \/etc\/<\/code><\/p>\n

sudo mkdir uwsgi<\/code><\/p>\n

cd uwsgi<\/code><\/p>\n

sudo mkdir vassals<\/code><\/p>\n

cd vassals<\/code><\/p>\n

sudo mkdir enabled<\/code><\/p>\n

sudo mkdir available<\/code><\/p>\n

Now we need to create an emperor.ini<\/code> file, which will contain the path for the other vassals at enabled<\/code>:<\/p>\n

sudo nano \/etc\/uwsgi\/vassals\/emperor.ini<\/code><\/p>\n

Add this lines to the file:<\/p>\n

[uwsgi]\n\nemperor = \/etc\/uwsgi\/vassals\/enabled<\/pre>\n
Now, it’s time to deamonize uwsgi. In order to do it, create a usgi.service<\/code> file at \/etc\/systemd\/system\/<\/code>:<\/p>\n
sudo vi \/etc\/systemd\/system\/uwsgi.service<\/code><\/p>\n
Now, paste the following content into it:<\/p>\n
[Unit]\nDescription=uWSGI Emperor\nAfter=syslog.target\n\n[Service]\nExecStart=\/usr\/local\/bin\/uwsgi --ini \/etc\/uwsgi\/vassals\/emperor.ini\n# Requires systemd version 211 or newer\nRuntimeDirectory=uwsgi\nRestart=always\nKillSignal=SIGQUIT\nType=notify\nStandardError=syslog\nNotifyAccess=all\n\n[Install]\nWantedBy=multi-user.target<\/pre>\n
To start the service<\/p>\n
sudo systemctl start uwsgi<\/code><\/p>\n
To check service status<\/p>\n
systemctl status uwsgi<\/code><\/p>\n
Lets enable the service. So that it starts at boot<\/p>\n
sudo systemctl enable uwsgi<\/code><\/p>\n
To stop the service<\/p>\n
sudo systemctl stop uwsgi<\/code><\/p>\n
Lets configure our django project to run with uwsgi.<\/p>\n
Lets create a file\u00a0\/etc\/uwsgi\/vassals\/available\/kb_web.ini<\/p>\n
vi\u00a0\/etc\/uwsgi\/vassals\/available\/web_app.ini<\/code><\/p>\n
# webapp_uwsgi.ini file\n[uwsgi]\n\n# Django-related settings\n# the base directory (full path)\nchdir           = \/var\/www\/webapp\n# Django's wsgi file\nmodule          = webapp.wsgi\nenable-threads = true\n\n# process-related settings\n# master\nmaster          = true\n# maximum number of worker processes\nprocesses       = 10\nlisten  = 100\n# the socket (use the full path to be safe\nsocket          = \/var\/www\/webapp\/webapp\/web_app.sock\n# ... with appropriate permissions - may be needed\nchmod-socket    = 666\n# clear environment on exit\nvacuum          = true\nmax-requests = 1000\n#limit-as = 128\ndaemonize =  \/var\/log\/uwsgi-emperor.log<\/pre>\n
Lets create a symlink to enabled<\/code> folder<\/p>\n
ln -s\u00a0\/etc\/uwsgi\/vassals\/available\/kb_web.ini\u00a0\/etc\/uwsgi\/vassals\/enabled\/<\/code><\/p>\n
Please make sure you’ve uploaded your project folder under \/var\/www<\/p>\n
ls -l \/var\/www\/webapp<\/code><\/span><\/span><\/p>\n
drwxr-xr-x 3 www-data www-data 4096 Sep 14 05:41 bin\ndrwxr-xr-x 6 root     root     4096 Oct  4 13:46 webapp\n-rwxr-xr-x 1 root     root      538 Aug 10 02:14 manage.py\n-rw-r--r-- 1 root     root      275 Aug 10 02:14 requirements<\/pre>\n
Lets manually verify the application by running this command<\/p>\n
python3 manage.py runserver 0.0.0.0:8000<\/code><\/p>\n
# python3 manage.py runserver 0.0.0.0:8000\nPerforming system checks...\n\nSystem check identified no issues (0 silenced).\nOctober 05, 2018 - 12:17:12\nDjango version 2.0.7, using settings 'kb1988.settings'\nStarting development server at http:\/\/0.0.0.0:8000\/\nQuit the server with CONTROL-C.<\/pre>\n
It looks fine and no python module errors.<\/p>\n
Configure nginx domain<\/h4>\n
Lets configure nginx virtual host<\/p>\n
vi \/etc\/nginx\/sites-available\/webapp.com<\/code><\/p>\n
Enter the below contents. You can adjust the folder path as per your needs.<\/p>\n
upstream web_app {\n     server unix:\/\/\/var\/www\/webapp\/webapp\/kb_web.sock; # for a file socket\n}\nserver {\n    # the port your site will be served on\n    listen      80;\n    # the domain name it will serve for\n    server_name pheonixsolutions.com\n    charset     utf-8;\n\n    # max upload size\n    client_max_body_size 75M;   # adjust to taste\n    location \/media  {\n        alias \/var\/www\/webapp\/webapp\/media;  # your Django project's media files - amend as required\n    }\n\n    location \/static {\n        alias \/var\/www\/webapp\/webapp\/static;\n    }\n\n    # Finally, send all non-media requests to the Django server.\n    location \/ {\n        uwsgi_pass  web_app;\n        include     \/etc\/nginx\/uwsgi_params; # the uwsgi_params file you installed\n    }\n}<\/pre>\n
Verify nginx syntax test<\/p>\n
nginx -t<\/code><\/p>\n
Reload nginx service<\/p>\n
\/etc\/init.d\/nginx reload<\/code><\/p>\n
Restart UWSGI<\/p>\n
service restart uwsgi\u00a0<\/code><\/p>\n
Your domain should work at http:\/\/pheonixsolutions.com<\/code><\/p>\n
Added tips:-<\/h4>\n
To create superuser admin

virtualenv command , which will give platform to run source\/bin\/activate.

source \/var\/www\/webapp\/bin\/activate<\/code><\/p>\n
python3 manage.py createsuperuser --username=devops --<\/code><\/p>\n
email=devops@pheonixsolutions.com<\/code>
\nEnter password: ********<\/code><\/p>\n
To collect static files from all the apps in one place<\/p>\n
python3 manage.py collectstatic<\/code><\/p>\n
If you run into errors, You should mention STATIC_ROOT path in your settings.py file. And then run above command again.<\/p>\n
STATIC_ROOT = '\/var\/www\/webapp\/webapp\/static\/'<\/pre>\n
\u00a0<\/p>\n
Steps to eradicate Django migration errors-“core_module issue” :<\/strong><\/h2>\n
In python you need to do migrate the changes on prod while its running. If we didn’t complete the migration properly.<\/p>\n
\u00a0<\/p>\n
This kind of error will make us more disappointing at a last stage of migration. we will see errors like shown below.<\/p>\n
\u00a0<\/p>\n
\"This<\/p>\n\n\n
As the error stats that this is an issue with core module. We believe that the code migration didn’t applied completely. <\/p>\n\n\n\n
To resolve that we need to run below commands:-<\/p>\n\n\n
python3.6 manage.py makemigrations core\npython3.6 manage.py migrate core<\/code><\/pre>\n
Now login to your django admin panel and check. The errors should be gone.<\/p>\n\n\n
That’s it. We’re done with the setup!<\/p>\n","protected":false},"excerpt":{"rendered":"
Setting up Django and your web server with uWSGI and nginx Date posted: 05-oct-2018 \u00a0 In this article, we will […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"jetpack_post_was_ever_published":false},"categories":[1022],"tags":[],"class_list":["post-2655","post","type-post","status-publish","format-standard","hentry","category-web-architecture","psol-cat-web-architecture"],"jetpack_publicize_connections":[],"jetpack_shortlink":"https:\/\/wp.me\/phn2x7-GP","jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/pheonixsolutions.com\/blog\/wp-json\/wp\/v2\/posts\/2655","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pheonixsolutions.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pheonixsolutions.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/pheonixsolutions.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/pheonixsolutions.com\/blog\/wp-json\/wp\/v2\/comments?post=2655"}],"version-history":[{"count":0,"href":"https:\/\/pheonixsolutions.com\/blog\/wp-json\/wp\/v2\/posts\/2655\/revisions"}],"wp:attachment":[{"href":"https:\/\/pheonixsolutions.com\/blog\/wp-json\/wp\/v2\/media?parent=2655"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pheonixsolutions.com\/blog\/wp-json\/wp\/v2\/categories?post=2655"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pheonixsolutions.com\/blog\/wp-json\/wp\/v2\/tags?post=2655"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}