Tutorial on how to deploy a Django application on Linux VPS with Apache, NGINX and uWSGI
sudo apt-get install python3-venv
- Create virtual env
python3 -m venv venv
- Clone repository
git clone your-url.git
-
Install requirementst
pip install -r requirements.txt -
Run the collectstatic command
python manage.py collectstatic -
Create the database
python manage.py migrate -
Create a superuser
python manage.py createsuperuser
- Make sure your settings.py has the following configurations:
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, "static")
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, "media")
- Run Django collectstatic
python manage.py collectstatic
- Install uwsgi on your virtual environment
sudo apt-get install python3.6-dev
sudo apt-get install build-essential libssl-dev libffi-dev python-dev
pip install wheel
pip install uwsgi
- Install and start Nginx
sudo apt-get install nginx
sudo /etc/init.d/nginx start
- Create the file uwsgi_params on your project path
vim uwsgi_params
---- file content -----
uwsgi_param QUERY_STRING $query_string;
uwsgi_param REQUEST_METHOD $request_method;
uwsgi_param CONTENT_TYPE $content_type;
uwsgi_param CONTENT_LENGTH $content_length;
uwsgi_param REQUEST_URI $request_uri;
uwsgi_param PATH_INFO $document_uri;
uwsgi_param DOCUMENT_ROOT $document_root;
uwsgi_param SERVER_PROTOCOL $server_protocol;
uwsgi_param REQUEST_SCHEME $scheme;
uwsgi_param HTTPS $https if_not_empty;
uwsgi_param REMOTE_ADDR $remote_addr;
uwsgi_param REMOTE_PORT $remote_port;
uwsgi_param SERVER_PORT $server_port;
uwsgi_param SERVER_NAME $server_name;
- Create NGINX config file at /etc/nginx/sites-available
upstream django {
server unix:///home/ubuntu/django-apache-nginx-uwsgi-vps-ubuntu/mysite.sock;
}
server {
listen 8000;
server_name example.com;
charset utf-8;
client_max_body_size 75M;
location /media {
alias /home/ubuntu/django-apache-nginx-uwsgi-vps-ubuntu/media;
}
location /static {
alias /home/ubuntu/django-apache-nginx-uwsgi-vps-ubuntu/static;
}
location / {
uwsgi_pass django;
include /home/ubuntu/django-apache-nginx-uwsgi-vps-ubuntu/uwsgi_params;
}
}
-
Create a symlink on sites-enabled sudo ln -s ~/path/to/your/mysite/mysite_nginx.conf /etc/nginx/sites-enabled/
-
Restart Nginx
sudo /etc/init.d/nginx restart -
Download an image to media folder and test
-
Run and test using Unix sockets
uwsgi --socket mysite.sock --module mysite.wsgi --chmod-socket=666 -
Create the ini file
[uwsgi]
chdir = /home/ubuntu/django-apache-nginx-uwsgi-vps-ubuntu
module = django_vps.wsgi
home = /home/ubuntu/venv
master = true
processes = 10
socket = /home/ubuntu/django-apache-nginx-uwsgi-vps-ubuntu/mysite.sock
vacuum = true
chmod-socket = 666
- Testing with .ini file
uwsgi --ini mysite_uwsgi.ini
sudo mkdir /etc/uwsgi
sudo mkdir /etc/uwsgi/vassals
sudo ln -s /home/ubuntu/django-apache-nginx-uwsgi-vps-ubuntu/mysite_uwsgi.ini /etc/uwsgi/vassals/
uwsgi --emperor /etc/uwsgi/vassals --uid www-data --gid www-data
https://uwsgi-docs.readthedocs.io/en/latest/Systemd.html
cd /etc/systemd/system/
sudo vim djangovps.service
======
[Unit]
Description=Django VPS uWSGI Emperor
After=syslog.target
[Service]
ExecStart=/home/ubuntu/venv/bin/uwsgi --emperor /etc/uwsgi/vassals --uid www-data --gid www-data
RuntimeDirectory=uwsgi
Restart=always
KillSignal=SIGQUIT
Type=notify
StandardError=syslog
NotifyAccess=all
User=ubuntu
[Install]
WantedBy=multi-user.target
======
sudo chmod 664 /etc/systemd/system/djangovps.service
sudo systemctl daemon-reload
sudo systemctl enable djangovps.service
sudo systemctl start djangovps.service
sudo systemctl status djangovps.service
journalctl -u djangovps.service
- disable nginx default symlink to open port 80
cd /etc/nginx/sites-enabled/
sudo rm -rf default
sudo /etc/init.d/nginx restart
sudo apt-get install apache2
sudo a2enmod proxy
sudo a2enmod proxy_http
sudo a2enmod proxy_balancer
sudo a2enmod lbmethod_byrequests
sudo systemctl restart apache2
- Creating the Vhost
cd /etc/apache2/sites-available
sudo vim django_vps.conf
<VirtualHost *:80>
ServerName 52.16.70.162
ProxyPass / http://127.0.0.1:8000/
ProxyPassReverse / http://127.0.0.1:8000/
</VirtualHost>
- Enable symlink on site-enable
sudo ln -s /etc/apache2/sites-available/django_vps.conf /etc/apach
e2/sites-enabled/
- Edit default vhost to your extra website
sudo apt-get install python-pip python-dev libpq-dev postgresql postgresql-contrib
adduser <username>
sudo su - postgres
psql
\password
\q
createuser --interactive
createdb <database name>
psql
ALTER DATABASE <database name> OWNER TO <role name>;
ALTER USER <username> WITH PASSWORD '<new password>';
add psycopg2 on requirements.txt
push + pull
install requirements.txt
sudo su
su postgres
psql
\list
\c djangodb
\dt ( show tables )
select * from auth_user;
\q
exit