Table of Contents

Set up Django With LSWS in CyberPanel

Django is a web application framework built with Python. Django has seen tremendous growth recently, and a lot of developers are moving towards this framework. Django's official slogan is “the web framework for perfectionists with deadlines.”

In this tutorial, we will set up a Django application for LiteSpeed Web Server with CyberPanel. We will use mod_passenger directives in a virtual host's document root .htaccess to define the application.

NOTE: These instructions also apply if you have manually set LSWS to read Apache config. They do not, however, apply to LSWS with other control panels (like cPanel or Plesk). For those, we recommend using CloudLinux Python selectors.

Prerequisites

Install Python 3

CentOS

yum install python3-devel
yum install python3-pip

Ubuntu

apt install build-essential
apt-get install python3-dev

Create a Domain

Create your domain on CyberPanel. For this example, let's use cyberdjangotest1.com, put it in the /home/cyberdjangotest1.com/ directory and make the owner be cyberdj:cyberdj, like so: 

drwx--x--x 5 cyberdj    cyberdj    4096 Aug  3 16:30 cyberdjangotest1.com

Install LiteSpeed Implementation of WSGI

Download the latest version of wsgi-lsapi.

Run the following commands: 

Cd  root
curl -O http://www.litespeedtech.com/packages/lsapi/wsgi-lsapi-1.6.tgz
tar xf wsgi-lsapi-1.6.tgz
cd wsgi-lsapi-1.6
python3 ./configure.py
make
cp lswsgi /usr/local/lsws/fcgi-bin/

Set up virtualenv for Django Application

We will setup virtualenv in the user’s home directory. To adhere to best practices, don't put virtualenv in the domain’s document root. 

Su - cyberdj
virtualenv --system-site-packages /home/cyberdjangotest1.com/virtualenv/
source /home/cyberdjangotest1.com/virtualenv/bin/activate
pip3 install django

Set up or Upload Django Application

If you already have a Django application, you can create a project folder, for example app1, at /home/cyberdjangotest1.com/app1/, and move your existing application into it.

For this example, we will create a brand new Django project named app1. 

cd /home/cyberdjangotest1.com/
django-admin startproject app1

Edit the project settings: 

vi /home/cyberdjangotest1.com/app1/app1/settings.py

Make sure allowed hosts looks like this: 

ALLOWED_HOSTS = ['*']

Create a static file directory. Normally static files are placed inside the document root, so you can create a /static/ directory in doc root: 

mkdir /home/cyberdjangotest1.com/public_html/static

To set the path for static files, add the following at the end of settings.py: 

STATIC_URL = '/static/'
STATIC_ROOT = '/home/cyberdjangotest1.com/public_html/static'

Visit your project directory. Run a few commands to start collecting static files and create super user: 

cd /home/cyberdjangotest1.com/app1/
python3 manage.py collectstatic
python3 manage.py migrate
python3 manage.py createsuperuser

Set up Django Application in .htaccess

To define a Django application, LSWS will use mod_passenger directives in the virtual host's doc root .htaccess. These directives can be used by LSWS:

Place something like the following in .htaccess (create the file if it doesn't exist): 

PassengerAppRoot "/home/cyberdjangotest1.com/app1/"
PassengerBaseURI "/"
PassengerPython "/usr/local/lsws/fcgi-bin/lswsgi"
PassengerAppEnv "Production"
# Add SetEnv to pass extra environments to the application
#SetEnv DJANGO_SETTINGS_MODULE ...
LS_PYTHONBIN=/home/cyberdjangotest1.com/virtualenv/bin/python
PYTHONHOME=/home/cyberdjangotest1.com/virtualenv/