====== 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 [[litespeed_wiki:config:mod_passenger|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 =====
  * Up-to-date installation of CyberPanel
  * Up-to-date installation of LiteSpeed Web Server

===== 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 =====

[[https://www.litespeedtech.com/open-source/litespeed-sapi/download|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:

  * ''PassengerBaseURI''
  * ''PassengerAppRoot''
  * ''PassengerAppEnv''
  * ''PassengerAppType''
  * ''PassengerStartupFile''
  * ''PassengerPython''
  * ''PassengerRuby''
  * ''PassengerNodejs''
  * ''PassengerUser''
  * ''PassengerGroup''

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/