Django

The OpenLiteSpeed Django One-Click app automatically installs performance web server openlitespeed, and Django. This image tends to be up to 2.5 times faster than Django on Nginx with Gunicorn! Developers can update files directly without using the built-in development server. OpenLiteSpeed features easy setup for SSL and RewriteRules. OLS is flexible and also supports Node.js and Ruby apps, as well as CMSs like WordPress.

Quick Start

Step 1.

DigitalOcean

Use the "OpenLiteSpeed Django 1-Click app" to create a Droplet with any plan you want. Click here to create an account and get a $50 Digital Ocean credit.

Google Cloud Platform (GCP)
  1. Login to the Google Cloud Platform and click Launch a VM instance on Compute Engine.
Amazon Web Services(AWS)
Method 1. Through Subscribe
  1. Subscribe to Django
  2. Click Continue to Launch and Launch
Method 2. Through EC2 console
  1. Open the Amazon EC2 console
  2. Locate the product by searching for "Django OpenLiteSpeed" from AWS Marketplace
  3. Click Select,Continue,Preview and launch (the default is the most recent version)
Microsoft Azure Cloud (Azure)
  1. Login to the Azure Portal and click Image Link.
  2. Click the GET IT NOW and Create buttons
  3. Choose any server plan you'd like to use, and create the server
Linode

Use the "OpenLiteSpeed Django StackScripts" to create a server with any plan you want. Click here to create an account

Step 2.

An interactive script that runs will first prompt you for your domain or subdomain.

You can press CTRL+C and continue to SSH. The prompt will open again the next time you log in, and will continue to do so until you finish the whole setup.

Please input a valid domain:
Please verify it is correct. [y/N]

Tip

Domain format accepts www.example.com or example.com. No need to include http:// or https://.

You can also automatically apply Let's Encrypt SSL if your domain is pointed to this server already. Enter y and your email address to finish the process.

Do you wish to issue a Let's encrypt certificate for this domain? [y/N]
Please enter your E-mail:
Please verify it is correct: [y/N]
Once finished, you should see Certificate has been successfully installed...

Do you wish to force HTTPS rewrite rule for this domain? [y/N]
Once finished, force HTTPS rules will be applied

Do you wish to update the system which include the web server? [Y/n]
This script will automatically go away after your domain has been added.

Step 3.

Visit the default script by entering http://Server_IP/ on your browser and you should see Hello, world!.

You can also enter http://Server_IP/admin/ to get the Django administration page

Start editing the Django project under /usr/local/lsws/Example/html/

Please access into virtual environment first

source /usr/local/lsws/Example/html/bin/activate

Django demo site structure:

demo
|-demo
   │-settings.py
   │-urls.py
   │-wsgi.py
   │-__init__.py
|-manage.py
|-public
   |-static
|-db.sqlite3
|-app
|-stderr.log

Update system software.

sudo apt-get update && sudo apt-get upgrade -y

Your system is installed and ready to use!

Components

The OpenLiteSpeed Django 1-Click Droplet installs several packages and performs other actions on your system.

Package Installation

Component Version
Linux Ubuntu 18.04.1
OpenLiteSpeed Latest from LiteSpeedtech Repo
Django Latest from APT
Certbot Latest from Certbot’s PPA

Other Actions

Enable Firewall

This droplet enables the UFW firewall to allow only SSH (port 22), HTTP (port 80) and HTTPS (port 443) access.

Set Up Demo Django Project

The droplet executes the following steps in order to set up a demo Django project called demo, and a Django app called app. These steps are taken automatically. You don't need to do anything.

  • Create a demo project called demo and Django app called app:

    django-admin startproject demo
    cd demo
    python3 manage.py startapp app
    

  • Edit settings.py to allow hosts:

    ALLOWED_HOSTS = ['*'] 
    

  • Edit settings.py to look for static files in a directory called static in our root directory:

    STATIC_URL = '/python/static/'
    STATIC_ROOT = '/usr/local/lsws/Example/html/demo/public/static'
    

  • Collect static files:

    mkdir -p public/static
    python3 manage.py collectstatic
    

  • Create a view which returns Hello, world! as an HTTP response:

    def index(request):
        return HttpResponse("Hello, world!")
    

  • Set a default url:
    urlpatterns = [
        path('', views.index, name='index'),
        path('admin/', admin.site.urls),
    ]
    
  • Change owner:

    chown -R nobody:nogroup /usr/local/lsws/Example/html/demo
    

  • Set up a context via Web Admin > Virtual Hosts > Context > Add:

    • Type = App Server
    • URI = /
    • Location = /usr/local/lsws/Example/html/demo/
    • Binary Path = /usr/local/lsws/fcgi-bin/lswsgi
    • Application Type = WSGI
    • Startup File = demo/wsgi.py
    • Environment = PYTHONHOME=/usr/local/lsws/Example/html

Benchmark Comparison

Use the following command to test from an x-CPU plan server(ab) to an x-CPU plan server(DOMAIN)

ab -n 100000 -k -H "Accept-Encoding: gzip,deflate" -c 100 http://DOMAIN/

Requests per Second (The larger the number, the better)

Nginx+Gunicorn Openlitespeed
700 1750

How to Access the Installed Software

From a terminal on your local computer, connect to the server as root, like so:

ssh root@use_your_server_ip
AWS
ssh ubuntu@use_your_server_ip

Be sure to substitute the server’s public IP address for use_your_server_ip.

Web Server Control Panel Access

Get the WebAdmin admin password:

cat .litespeed_password

GCP
cat /home/ubuntu/.litespeed_password

Visit https://use_your_droplet_ip:7080 to access WebAdmin in a browser.

By default, WebAdmin uses port 7080. To allow access to 7080 from your IP(e.g. 1.2.3.4):

ufw allow from 1.2.3.4 to any port 7080
You can also allow all IPs access to port 7080:
ufw allow 7080
We suggest turning this port off once you've finished setup:
ufw delete allow 7080

Django Administration Page

Run the following command in the project directory to setup an account and password:

python3 manage.py createsuperuser

Optional Setup

Enable HTTPS

Setting up an SSL certificate enables HTTPS on the web server, which secures the traffic between the server and the clients connecting to it. Certbot is a free and automated way to set up SSL certificates on a server.

Step 1. Register Domain

To use Certbot, you’ll need a registered domain name and DNS records:

  • An A record from the domain (e.g., example.com) to the server’s IP address

  • An A record from the domain prefaced with www (e.g., www.example.com) to the server’s IP address.

Step 2. Add Domain to Listener

Navigate to OpenLiteSpeed Web Server WebAdmin > Listeners, and add Your Domain to HTTP/HTTPS.

Step 3. Certbot

Once the DNS records are set up, you can generate the SSL certificate. Be sure to substitute the correct domain name in the following command:

certbot certonly --webroot -w /var/www/html/ -d example.com -d www.example.com
If certificate verification is a success, you should find your certificate files stored in /etc/letsencrypt/

Step 4. Set SSL for HTTPS

Navigate to OpenLiteSpeed Web Server WebAdmin > Listeners > SSL, and edit the following three items:

  • Private Key File = /etc/letsencrypt/live/example.com/privkey.pem
  • Certificate File = /etc/letsencrypt/live/example.com/fullchain.pem
  • Chained Certificate = Yes

Save and perform a Graceful Restart.

Now your server should support TLS1.1, TLS 1.2, and TLS 1.3.

Step 5. Redirect HTTP to HTTPS

HTTPS traffic on port 443 is already allowed through the firewall. After you set up HTTPS, you can optionally rewrite all HTTP traffic to HTTPS.

Add the following rules to OpenLiteSpeed Web Server WebAdmin > Virtual Hosts > Rewrite > Rewrite Rules

RewriteCond %{SERVER_PORT} 80
RewriteRule ^(.*)$ https://example.com/$1 [R,L]

Method for Uploading Files

You can serve files from the web server by adding them to the web root using SFTP or other tools.

Frequently Asked Questions

How do I Reset my Web Server WebAdmin Password?

If you forget your password, you may run the following command to reset it:

/usr/local/lsws/admin/misc/admpass.sh

It will ask for the WebAdmin username, which should be admin. Then, enter your new password.

How do I Create Additional Virtual Hosts?

Auto Setup via Script

This method will automatically set up Listener/VirtualHost/Force SSL/Let's Encrypt/WordPress.

Interactive mode

wget https://raw.githubusercontent.com/litespeedtech/ls-cloud-image/master/Setup/vhsetup.sh
chmod +x vhsetup.sh
bash vhsetup.sh
Or just run the script without downloading it:
/bin/bash <( curl -sk https://raw.githubusercontent.com/litespeedtech/ls-cloud-image/master/Setup/vhsetup.sh )

CLI mode

wget https://raw.githubusercontent.com/litespeedtech/ls-cloud-image/master/Setup/vhsetup.sh
chmod +x vhsetup.sh
bash vhsetup.sh -d www.example.com -le admin@example.com -f -w
Or just run the script without downloading it:
/bin/bash <( curl -sk https://raw.githubusercontent.com/litespeedtech/ls-cloud-image/master/Setup/vhsetup.sh ) -d www.example.com -le admin@example.com -f -w

  • Please be sure that your domain is already pointing to the server when using -le YOUR_EMAIL

  • Please be sure that your environment has php/sql service/sql root password when using -w

Manual Setup

By default, OpenLiteSpeed has an example virtual host already created. You can create more virtual hosts if you like. See Create Virtual Hosts on OpenLiteSpeed.

How do I Create Additional Apps by Context?

How do I Change the Django Startup File?

If you want to change the default startup file name from wsgi.py to demo.js, just update the Context and set Startup File = demo.py.

How do I Create Django with a Virtual Environment?

How do I Fix Permission Issues?

chown -R nobody:nogroup /usr/local/lsws/Example/html/demo

Change /usr/local/lsws/Example/demo to your actual project path

How do I Set Up a Wagtail Project with an Existing Config?

Move default "Hello World" demo site from server:

mv /usr/local/lsws/Example/html/demo /tmp

Install Wagtail python package:

pip3 install wagtail

Start a new demo site:

wagtail start demo

Access the project directory:

cd demo

Install the required package:

pip3 install -r requirements.txt
python3 manage.py migrate

Create a static file folder:

mkdir -p /usr/local/lsws/Example/html/demo/demo/public/static

Add these two lines to the end of /usr/local/lsws/Example/html/demo/demo/settings/base.py:

STATIC_URL = '/python/static/'
STATIC_ROOT = '/usr/local/lsws/Example/html/demo/public/static'

Collect static files:

python3 manage.py collectstatic

Create superuser for admin page access:

python3 manage.py createsuperuser

Change owner to default LiteSpeed permissions:

chown -R nobody:nogroup /usr/local/lsws/Example/html/demo/

Front page:

Admin page:

How do I Import my Django Project From Git?

Let's use pyconbalkan as an example. To import the project, run the following command:

git clone https://github.com/PythonBalkan/pyconbalkan

Install your project's requirements:

pip3 install -r requirements.txt

Create a .env file, and the content required by the project. Run migrate:

python3 manage.py migrate

Follow the Set Up Demo Django Project instructions to set up settings.py, collect static files, and change owner and context. More info

You should see the following screen:

API Creation

DigitalOcean

In addition to creating a Droplet from the Openlitespeed Django 1-Click application using the control panel, you can also use the DigitalOcean API.

The following example creates an Openlitespeed Django 18.04 Droplet called “My-Droplet” in the NYC3 datacenter, with 1 GB RAM:

curl -X POST "https://api.digitalocean.com/v2/droplets" \
    -d'{"name":"My-Droplet","region":"nyc3","size":"s-1vcpu-1gb","image":"openlitespeed-django-18-04"}' \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json"
AWS

In addition to creating an instance from the WordPress with LiteSpeed Cache using the AWS Management Console, you can also use the AWS Command Line Interface.

The following example creates an t2.micro Instance with WordPress+LiteSpeed Cache AMI:

aws ec2 run-instances --image-id ami-05f5c0bf6df2c6990 \
                        --subnet-id subnet-XXXXXXX \
                        --security-group-ids sg-XXXXXXXXXXXXXX \
                        --count 1 \
                        --instance-type t2.micro \
                        --key-name XXXXXX \
                        --query "Instances[0].InstanceId"
Please replace XXX to your own settings.

GCP

Get the exact name of the Django image from LiteSpeed's project, gc-image-pub:

gcloud compute images list --project=gc-image-pub --filter="name ~ 'openlitespeed django'"

Create an instance, replacing INSTANCE_NAME with the name of your choice, and IMAGE_NAME with the name obtained from the previous command:

gcloud compute instances create INSTANCE_NAME --image-project=gc-image-pub --image=IMAGE_NAME
Azure

The first time you launch, you may need to accept the marketplace terms using the following command:

Get-AzureRmMarketplaceTerms \
    -Publisher "litespeed_technologies" \
    -Product "openlitespeed-django" \
    -Name "openlitespeed-django" \
    | Set-AzureRmMarketplaceTerms -Accept
Find the release version you prefer:
az vm image list \
    --location westus \
    --publisher litespeed_technologies \
    --offer openlitespeed-django \
    --all \
    --output table
Launch VM from that image:
az vm create \
    --resource-group your-group \
    --image litespeed_technologies:openlitespeed-django:openlitespeed-django:1.0.0 \
    --name myVM \
    --admin-username azure

Feel free to replace resource-group, image version, name, admin name, --generate-ssh-keys and more options with your own preferences.

Note

This request, like any other request that makes a change to your account, requires that your token has “write” scope assigned to it.