OpenLiteSpeed

https://docs.openlitespeed.org/
Admin
OpenLiteSpeed is an open-source, high-performance web server that serves as the open-source edition...
Tokens:53,169
Snippets:810
Trust Score:9.8
Update:2 months ago
Show doc for...
Tokens:
Raw
### Install Command Examples

Source: https://docs.openlitespeed.org/installation/cli

Various configurations for installing OpenLiteSpeed, PHP, and databases.

```bash
ols install
```

```bash
ols install --php85 --database mysql
```

```bash
ols install --config /etc/ols-cli/install.json --php85 --database mysql --http-port 80 --https-port 443
```

```bash
ols install --no-listeners
```

--------------------------------

### Execute Installation Script

Source: https://docs.openlitespeed.org/installation/source

Run the install script to finalize the setup process.

```bash
./install.sh
```

--------------------------------

### Configure custom installation

Source: https://docs.openlitespeed.org/installation/cli

Sets up the configuration directory and copies the example file. Run the installation command to apply the custom configuration.

```bash
mkdir -p /etc/ols-cli
cp docs/install.example.json /etc/ols-cli/install.json
```

```bash
ols install
```

--------------------------------

### Ghost Installation Prompts

Source: https://docs.openlitespeed.org/apps/ghost

Example of the interactive installation prompts and successful completion message.

```text
Answer the installation questions:

? Enter your blog URL: http://example.com
? Enter your MySQL hostname: localhost
? Enter your MySQL username: root
? Enter your MySQL password: [hidden]
? Enter your Ghost database name: ghost_blog

Ghost was installed successfully! To complete setup of your publication, visit:

http://example.com/ghost/
```

--------------------------------

### Run Ghost-CLI Installation

Source: https://docs.openlitespeed.org/apps/ghost

Initiates the local installation process using Ghost-CLI.

```bash
ghost install local
```

--------------------------------

### Install Command Syntax

Source: https://docs.openlitespeed.org/installation/cli

General syntax for the install command.

```bash
ols install [options]
```

--------------------------------

### Compile and Install PHP

Source: https://docs.openlitespeed.org/config/php

Build the PHP binary from source and install it to the system.

```bash
$ sudo make
$ sudo make install
```

--------------------------------

### Install Django and Create Project

Source: https://docs.openlitespeed.org/config/appserver/python

Install Django via pip and initialize a new project.

```bash
pip install django
```

```bash
cd /var/www/html/
django-admin startproject demo
```

--------------------------------

### Install MySQL Server

Source: https://docs.openlitespeed.org/apps/ghost

Installs the MySQL server package on the system.

```bash
apt-get install mysql-server
```

--------------------------------

### Install Ghost-CLI

Source: https://docs.openlitespeed.org/apps/ghost

Global installation of the Ghost command-line interface using npm.

```bash
npm install -g ghost-cli@latest
```

--------------------------------

### Install Django

Source: https://docs.openlitespeed.org/config/appserver/python

Install the Django framework using pip3.

```bash
pip3 install django
```

--------------------------------

### Verify Installation Success

Source: https://docs.openlitespeed.org/installation/binary

Confirmation message displayed upon successful installation of the startup script.

```text
[OK] The startup script has been successfully installed!
```

--------------------------------

### Install OpenLiteSpeed CLI

Source: https://docs.openlitespeed.org/installation/cli

Use the one-line installer to download and install the OpenLiteSpeed CLI binary.

```bash
bash <(curl -fsSL https://raw.githubusercontent.com/litespeedtech/ols-cli/master/install_olscli.sh)
```

--------------------------------

### Install Flask and Create Project Directory

Source: https://docs.openlitespeed.org/config/appserver/python

Install Flask via pip and set up the project directory structure.

```bash
pip3 install flask
```

```bash
mkdir /var/www/html/demo
cd /var/www/html/demo
```

--------------------------------

### Install Rails and Node.js

Source: https://docs.openlitespeed.org/config/appserver/ruby

Install the Rails gem and Node.js runtime.

```bash
gem install rails
apt install node.js
```

--------------------------------

### Create Installation Directory

Source: https://docs.openlitespeed.org/apps/ghost

Creates the target directory for the Ghost application and navigates into it.

```bash
mkdir -p /home/ghost/app/
cd /home/ghost/app/
```

--------------------------------

### Install Node.js

Source: https://docs.openlitespeed.org/config/appserver/nodejs

Commands to install Node.js on CentOS and Ubuntu systems.

```bash
yum install nodejs
```

```bash
apt-get install nodejs
```

--------------------------------

### Configure Ghost Setup

Source: https://docs.openlitespeed.org/apps/ghost

Runs the setup command with specific flags to skip Nginx, systemd, and SSL configurations.

```bash
ghost setup --no-setup-nginx --no-setup-systemd --no-setup-ssl --no-start
```

--------------------------------

### Install OpenLiteSpeed Binary

Source: https://docs.openlitespeed.org/installation/binary

Extract the downloaded archive and execute the installation script.

```bash
tar -zxvf openlitespeed-*.tgz
cd openlitespeed
./install.sh
```

--------------------------------

### Install GDB and Debug Build

Source: https://docs.openlitespeed.org/bugreport

Install the GDB debugger and update the OpenLiteSpeed installation to a debug build to capture call stack information during crashes.

```bash
yum install gdb
/usr/local/lsws/admin/misc/lsup.sh -b -s -v <version>
```

--------------------------------

### Install LiteSpeed with WordPress and MariaDB

Source: https://docs.openlitespeed.org/installation/script

Runs the local script file with the WordPress installation flag.

```bash
# To install LiteSpeed with WordPress and MariaDB"
./ols1clk.sh -W
```

--------------------------------

### Install Composer

Source: https://docs.openlitespeed.org/apps/pimcore

Use this command to install Composer globally on your server if it is not already present.

```bash
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
```

--------------------------------

### Run the lssetup script

Source: https://docs.openlitespeed.org/config/advanced/cgroups

Execute the setup script to configure the operating system and LiteSpeed configuration for cgroups and namespaces.

```bash
sudo /usr/local/lsws/lsns/bin/lssetup
```

--------------------------------

### Install OpenLiteSpeed and LSPHP

Source: https://docs.openlitespeed.org/installation/script

Executes the one-click script to install only the core web server and PHP components.

```bash
bash <( curl -k https://raw.githubusercontent.com/litespeedtech/ols1clk/master/ols1clk.sh )
```

--------------------------------

### Install Bouncer

Source: https://docs.openlitespeed.org/security/crowdsec

Install the firewall bouncer to enable automatic blocking of malicious IPs.

```bash
apt install crowdsec-firewall-bouncer-iptables
```

```bash
dnf install crowdsec-firewall-bouncer-iptables
```

--------------------------------

### Install Rack and Ruby LSAPI

Source: https://docs.openlitespeed.org/config/appserver/ruby

Install the required Rack and ruby-lsapi gems for LSAPI support.

```bash
gem install rack -v 1.6.11
gem install ruby-lsapi
```

--------------------------------

### Configure Module Parameters

Source: https://docs.openlitespeed.org/modules

Example parameter configurations for the cache module.

```text
checkPrivateCache   1
checkPublicCache    1
maxCacheObjSize     10000000
maxStaleAge         0
qsCache             1
reqCookieCache      1
respCookieCache     1
ignoreReqCacheCtrl  1
ignoreRespCacheCtrl 0
enableCache         0
expireInSeconds     3600
enablePrivateCache  0
privateExpireInSeconds 3600
```

```text
checkPublicCache    1
checkPrivateCache   1
maxCacheObjSize     10000000
maxStaleAge         200
qsCache             1
reqCookieCache      1
ignoreReqCacheCtrl  1
ignoreRespCacheCtrl 0
respCookieCache     ``
storagepath         cachedata
noCacheDomain
noCacheUrl
no-vary             0
addEtag             |0
enableCache         0
expirelnSeconds     3600
enablePrivateCache  0
privateExpirelnSeconds 3600
```

--------------------------------

### WebAdmin Console Log Format Example

Source: https://docs.openlitespeed.org/config/logs

Example format string for use in the WebAdmin Console.

```text
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"
```

--------------------------------

### Install OpenLiteSpeed via CustomBuild

Source: https://docs.openlitespeed.org/panel/directadmin

Run these commands from the /usr/local/directadmin/custombuild/ directory to set up OpenLiteSpeed and PHP.

```bash
./build set webserver openlitespeed
./build set php1_mode lsphp
./build openlitespeed
./build php
./build rewrite_confs
```

```bash
./build set webserver openlitespeed
./build set php1_mode lsphp
./build set php2_mode lsphp
./build set php3_mode lsphp
./build openlitespeed
./build php
./build rewrite_confs
```

--------------------------------

### Install OpenLiteSpeed, WordPress, and MariaDB

Source: https://docs.openlitespeed.org/installation/script

Executes the one-click script to install the full stack including WordPress and the LiteSpeed Cache plugin.

```bash
bash <( curl -k https://raw.githubusercontent.com/litespeedtech/ols1clk/master/ols1clk.sh ) -w
```

--------------------------------

### Custom Bubblewrap command example

Source: https://docs.openlitespeed.org/config/advanced/bubblewrap

A simple example of a fully qualified bubblewrap command line configuration.

```bash
/bin/bwrap --dev-bind / /
```

--------------------------------

### Install LiteSpeed with Default PHP

Source: https://docs.openlitespeed.org/installation/script

Runs the local script file to install the web server with default PHP settings.

```bash
# To install LiteSpeed with default PHP Version.
./ols1clk.sh
```

--------------------------------

### Install Pimcore Application

Source: https://docs.openlitespeed.org/apps/pimcore

Run the installation script within the project directory to configure the database and admin credentials.

```bash
 cd html
 ./vendor/bin/pimcore-install
```

--------------------------------

### Install Bubblewrap on Ubuntu

Source: https://docs.openlitespeed.org/config/advanced/bubblewrap

Use the apt package manager to install bubblewrap on Ubuntu systems.

```bash
sudo apt install bubblewrap
```

--------------------------------

### Install GeoIP development dependencies

Source: https://docs.openlitespeed.org/config/advanced/geolocation

Installs the necessary development headers and zlib libraries for GeoIP.

```bash
yum install GeoIP-devel zlib-devel
```

--------------------------------

### User settings output

Source: https://docs.openlitespeed.org/config/advanced/cgroups

Example JSON output showing resource configuration for a user.

```json
2024-07-25 15:22:13.230 [INFO] Error opening /usr/local/lsws/lsns/conf/lsns.conf: [Errno 2] No such file or directory: '/usr/local/lsws/lsns/conf/lsns.conf', continuing with default min uid 1000
{
    "1001": {
        "name": "user2",
        "cpu": "20",
        "io": "100M",
        "iops": "",
        "mem": "500M",
        "tasks": "20K"
    }
}
```

--------------------------------

### Example directory listing output without Bubblewrap

Source: https://docs.openlitespeed.org/config/advanced/bubblewrap

Example output showing full directory access when Bubblewrap is disabled.

```text
Array ( [0] => . [1] => .. [2] => bin [3] => bob [4] => boot [5] => cdrom [6] => dev [7] => etc [8] => home [9] => lib [10] => lib32 [11] => lib64 [12] => libx32 [13] => lost+found [14] => media [15] => mnt [16] => opt [17] => proc [18] => root [19] => run [20] => sbin [21] => snap [22] => srv [23] => swapfile [24] => sys [25] => tmp [26] => usr [27] => var )
```

--------------------------------

### Install CrowdSec repositories

Source: https://docs.openlitespeed.org/security/crowdsec

Run this command to add the official CrowdSec repositories to your system.

```bash
curl -s https://install.crowdsec.net | sudo sh
```

--------------------------------

### Install Ruby Packages on Ubuntu

Source: https://docs.openlitespeed.org/config/appserver/ruby

Use rbenv and apt to install Ruby on Ubuntu systems.

```bash
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
apt install rbenv libreadline-dev ruby-dev -y
rbenv install 2.5.0
rbenv global 2.5.0
```

--------------------------------

### Install LiteSpeed ACME

Source: https://docs.openlitespeed.org/config/advanced/acme

Execute the installation script from the root of the LiteSpeed directory to set up the ACME environment.

```bash
/usr/local/lsws/admin/misc/install_acme.sh
```

--------------------------------

### Install the LiteSpeed repository

Source: https://docs.openlitespeed.org/installation/repo

Run this command to add the LiteSpeed repository to your system.

```bash
sudo wget -O - https://repo.litespeed.sh | sudo bash
```

--------------------------------

### Install LiteSpeed with WordPress and MySQL

Source: https://docs.openlitespeed.org/installation/script

Runs the local script file to install WordPress using the MySQL database driver.

```bash
# To install LiteSpeed with WordPress and Mysql"
./ols1clk.sh -W --with-mysql
```

--------------------------------

### Create config.ru for Verification

Source: https://docs.openlitespeed.org/config/appserver/ruby

Create a basic Rack application to verify the Ruby LSAPI setup.

```ruby
app = proc do |env|
    message = "It works!\n"
    version = "Ruby %s\n" % RUBY_VERSION
    response = [message, version].join("\n")
    [200, {"Content-Type" => "text/plain"}, [response]]
end
run app
```

--------------------------------

### Install PHP build dependencies

Source: https://docs.openlitespeed.org/config/php/custom

Install required system packages before initiating the PHP build process.

```bash
apt-get install -y pkg-config libxml2-dev build-essential libssl-dev libzip-dev libsqlite3-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libonig-dev
```

--------------------------------

### Configure Apache VirtualHost

Source: https://docs.openlitespeed.org/config/reverseproxy/lscache

Example of an Apache VirtualHost configuration block.

```apache
<VirtualHost 192.0.2.0:443>


```

--------------------------------

### Install Python3 Development Packages on Ubuntu

Source: https://docs.openlitespeed.org/config/appserver/python

Commands to install build essentials and Python 3 development headers on Ubuntu systems.

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

--------------------------------

### Install the Security Engine

Source: https://docs.openlitespeed.org/security/crowdsec

Install the core CrowdSec security engine using the package manager appropriate for your distribution.

```bash
apt install crowdsec
```

```bash
dnf install crowdsec
```

--------------------------------

### Compile and Install wsgi-lsapi

Source: https://docs.openlitespeed.org/config/appserver/python

Steps to download, compile, and move the wsgi-lsapi binary to the OpenLiteSpeed fcgi-bin directory.

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

--------------------------------

### Log Output Examples

Source: https://docs.openlitespeed.org/config/advanced/geolocation

Expected log output for various IP geolocation scenarios.

```text
[REWRITE] Rule: Match '/' with pattern '^(.*)$', result: 2
[REWRITE] Cond: Match 'CA' with pattern '^(CA)$', result: 2
[REWRITE] Source URI: '/' => Result URI: 'https://en.wikipedia.org/wiki/Canada'
```

```text
[REWRITE] Rule: Match '/' with pattern '^(.*)$', result: 2
[REWRITE] Cond: Match 'EU' with pattern '^(EU)$', result: 2
[REWRITE] Source URI: '/' => Result URI: 'https://en.wikipedia.org/wiki/Europe'
```

```text
[REWRITE] Rule: Match '/' with pattern '^(.*)$', result: 2
[REWRITE] Cond: Match 'JP' with pattern '^(CA)$', result: -1
[REWRITE] Rule: Match '/' with pattern '^(.*)$', result: 2
[REWRITE] Cond: Match 'JP' with pattern '^(EU)$', result: -1
```

--------------------------------

### Compile and Install a Module

Source: https://docs.openlitespeed.org/modules

Commands to build a module from source and move the resulting library to the OpenLiteSpeed modules directory.

```bash
cd /openlitespeed_download/src/modules/example
make
```

```bash
cp example.so /usr/local/lsws/modules
```

--------------------------------

### Initialize Database and Admin User

Source: https://docs.openlitespeed.org/config/appserver/python

Run migrations and create the superuser account.

```bash
python manage.py migrate
python manage.py createsuperuser
```

--------------------------------

### Lssetup help output

Source: https://docs.openlitespeed.org/config/advanced/cgroups

The output displayed when running the help command for the LiteSpeed Containers Setup Program.

```text
usage: setup [-h] [-l LOG] [-q] [-s SERVER_ROOT] [-c CGROUPS] [-i CGROUPS_INIT] [-n NAMESPACE] [-m NAMESPACE_INIT] [-g] [-t] [-u] [-r]

LiteSpeed Containers Setup Program

options:
  -h, --help            show this help message and exit
  -l LOG, --log LOG     set logging level, 10=Debug, 20=Info, 30=Warning, 40=Error. Default is Info
  -q, --quiet           turns off all logging and only outputs what is requested.
  -s SERVER_ROOT, --server_root SERVER_ROOT
                        the LiteSpeed SERVER_ROOT
  -c CGROUPS, --cgroups CGROUPS
                        The minimum value for cgroups
  -i CGROUPS_INIT, --cgroups-init CGROUPS_INIT
                        The cgroups value if not set currently
  -n NAMESPACE, --namespace NAMESPACE
                        The minimum value for namespace
  -m NAMESPACE_INIT, --namespace-init NAMESPACE_INIT
                        The namespace value if not set currently
  -g, --no-config       Skips checking of LiteSpeed Config
  -t, --no-subtree_control
                        Skips checking of system cgroup.subtree_control file
  -u, --no-upgrade      Does not check the version of LiteSpeed
  -r, --revert-config   Reverts modified LiteSpeed config file
```

--------------------------------

### Shell CGI Hello World Script

Source: https://docs.openlitespeed.org/config/appserver/cgi

A basic shell script example for CGI execution.

```bash
[root@localhost cgi-bin]# cat /usr/local/lsws/DEFAULT/cgi-bin/helloworld
#!/bin/sh

date=`date -u '+%a, %d %b %Y %H:%M:%S %Z'`

cat << EOF
Content-type: text/plain
Expires: $date

Hello World

EOF
[root@localhost cgi-bin]#
```

--------------------------------

### Install AWStats

Source: https://docs.openlitespeed.org/modules/awstats

Commands to install AWStats on different Linux distributions.

```bash
apt install awstats -y
```

```bash
dnf install epel-release
dnf install awstats
```

--------------------------------

### Define the uwsgi service configuration

Source: https://docs.openlitespeed.org/config/advanced/uwsgi

Example content for the systemd service file, specifying the execution path and user.

```ini
[Unit]
Description=Example uwsgi service
After=network-online.target remote-fs.target nss-lookup.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/usr/bin/uwsgi /home/www-data/html/example.ini
User=www-data
```

--------------------------------

### Override configuration with flags

Source: https://docs.openlitespeed.org/installation/cli

Overrides settings in the install.json file using command-line arguments during installation.

```bash
ols install --config /etc/ols-cli/install.json --php85 --database mysql --http-port 80 --https-port 443
```

--------------------------------

### Example directory listing output

Source: https://docs.openlitespeed.org/config/advanced/bubblewrap

Expected output when Bubblewrap is active, showing restricted directory access.

```text
Array ( [0] => . [1] => .. [2] => bin [3] => dev [4] => etc [5] => lib [6] => lib64 [7] => proc [8] => run [9] => sbin [10] => tmp [11] => usr [12] => var )
```

--------------------------------

### Verify PHP version

Source: https://docs.openlitespeed.org/config/php/custom

Check the installed PHP version and module information via the command line.

```bash
/usr/local/lsws/lsphp8/bin/lsphp -v
PHP 8.4.10 (litespeed) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.4.10, Copyright (c) Zend Technologies
```

--------------------------------

### Example 7G Log Entry

Source: https://docs.openlitespeed.org/apps/7gfirewall

Sample output format found in the 7G_log.txt file after a blocked request.

```text
1.2.3.4 - 2021/10/08 01:06:38 - GET - HTTP/1.1 - / - fullclick - - - Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.71 Safari/537.36
```

--------------------------------

### Initialize Django Database and Admin

Source: https://docs.openlitespeed.org/config/appserver/python

Run migrations and create an administrative superuser.

```bash
python3 manage.py migrate
python3 manage.py createsuperuser
```

--------------------------------

### Create Node.js Application

Source: https://docs.openlitespeed.org/config/appserver/nodejs

A basic HTTP server script to verify the Node.js application setup.

```javascript
const http = require('http');

const hostname = '127.0.0.1';
const port = 3000;

const server = http.createServer((req, res) => {
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain');
  res.end('Hello World from node js app.js\n');
});

server.listen(port, hostname, () => {
  console.log(`Server running at http://${hostname}:${port}/`);
});
```

--------------------------------

### Perl CGI Hello World Script

Source: https://docs.openlitespeed.org/config/appserver/cgi

A basic Perl script example for CGI execution.

```perl
[root@localhost cgi-bin]# cat /usr/local/lsws/DEFAULT/cgi-bin/helloworld2
#!/usr/bin/perl

 print "Content-type: text/html\n\n";
 print <<HTML;
 <html>
 <head>
 <title>A Simple Perl CGI</title>
 </head>
 <body>
 <h1>A Simple Perl CGI</h1>
 <p>Hello World</p>
 </body>
HTML
exit; 
[root@localhost cgi-bin]#
```

--------------------------------

### Create Rails Project

Source: https://docs.openlitespeed.org/config/appserver/ruby

Initialize a new Rails application named demo.

```bash
rails new demo
```

--------------------------------

### Install LSPHP packages

Source: https://docs.openlitespeed.org/installation/repo

Install specific versions of LSPHP and associated modules.

```bash
sudo apt-get install lsphp84 lsphp84-common lsphp84-mysql
```

```bash
sudo yum install lsphp84 lsphp84-common lsphp84-mysqlnd
```

--------------------------------

### Execute manual PHP build script

Source: https://docs.openlitespeed.org/config/php/custom

Run the pre-generated script from the shell to start the compilation process.

```bash
/usr/local/lsws/phpbuild/buildphp_manual_run.sh
```

--------------------------------

### Example certificate list output

Source: https://docs.openlitespeed.org/config/advanced/acme

Sample output format returned by the acme.sh --list command.

```text
Main_Domain     KeyLength  SAN_Domains                    CA               Created               Renew
autols.website  "ec-256"   autols.shop,autosslls.website  LetsEncrypt.org  2025-09-22T19:40:16Z  2025-11-20T19:40:16Z
```

--------------------------------

### Initialize Django Project

Source: https://docs.openlitespeed.org/config/appserver/python

Create a new Django project directory structure.

```bash
mkdir -p /var/www/html/
cd /var/www/html/
django-admin startproject demo
```

--------------------------------

### Create a new site

Source: https://docs.openlitespeed.org/installation/cli

Commands for initializing new sites with various configuration options like WordPress, SSL, and security features.

```bash
ols site create example.com
```

```bash
ols site create example.com --wp
```

```bash
ols site create example.com --wp --le
```

```bash
ols site create example.com --wp --le --php85 --enable-owasp --enable-recaptcha --hsts --enable-ns
```

--------------------------------

### Install GeoIP data on CentOS

Source: https://docs.openlitespeed.org/config/advanced/geolocation

Installs the GeoIP-data package required for geolocation functionality.

```bash
yum install GeoIP-data
```

--------------------------------

### Create Pimcore Project

Source: https://docs.openlitespeed.org/apps/pimcore

Commands to navigate to the web directory and initialize a new Pimcore project using either the skeleton or demo package.

```bash
cd /var/www/
```

```bash
COMPOSER_MEMORY_LIMIT=-1 composer create-project pimcore/skeleton html
```

```bash
COMPOSER_MEMORY_LIMIT=-1 composer create-project pimcore/demo html
```

--------------------------------

### Create WSGI Entry Point

Source: https://docs.openlitespeed.org/config/appserver/python

Commands to create the WSGI file and the content required to map the application path.

```bash
vi /var/www/html/demo/wsgi.py
```

```python
#!/usr/bin/env python
import sys

sys.path.insert(0, '/var/www/html/demo')

from app import app as application
```

--------------------------------

### Install OpenLiteSpeed

Source: https://docs.openlitespeed.org/installation/repo

Install the OpenLiteSpeed server package using your distribution's package manager.

```bash
sudo apt-get -y install openlitespeed
```

```bash
sudo yum install openlitespeed -y
```

--------------------------------

### Create Virtual Host Directories

Source: https://docs.openlitespeed.org/config/reverseproxy/template

Initialize the directory structure required for the new virtual host.

```bash
mkdir /usr/local/lsws/proxy1
mkdir /usr/local/lsws/proxy1/{html,logs,conf}
chown lsadm:lsadm /usr/local/lsws/proxy1/conf
```

--------------------------------

### Initialize Virtual Environment

Source: https://docs.openlitespeed.org/config/appserver/python

Initialize the virtual environment using virtualenv.

```bash
virtualenv /var/www/html/
```

```bash
virtualenv -p python3 --system-site-packages /var/www/html/
```

--------------------------------

### Build and test locally

Source: https://docs.openlitespeed.org/installation/cli

Commands for building the binary from source and executing the test suite.

```bash
go build -o ols ./cmd/ols
```

```bash
go test ./...
```

```bash
go test -v ./...
```

--------------------------------

### Build Bubblewrap from Source

Source: https://docs.openlitespeed.org/config/advanced/bubblewrap

Manual build steps for environments like Ubuntu 16.04 and 18.04 where a newer version is required.

```bash
sudo apt install pkg-config libcap-dev automake
git clone https://github.com/containers/bubblewrap.git
cd bubblewrap
git checkout v0.4.1
./autogen.sh
make
sudo make install
sudo ln -s /usr/local/bin/bwrap /bin/bwrap
sudo mv /usr/bin/bwrap /usr/bin/bwrap.dist
sudo ln -s /usr/local/bin/bwrap /usr/bin/bwrap
```

--------------------------------

### Install LiteSpeed Collection

Source: https://docs.openlitespeed.org/security/crowdsec

Install the specific collection for LiteSpeed to enable log parsing and attack scenarios.

```bash
cscli collections install crowdsecurity/litespeed
```

--------------------------------

### Create a systemd service file

Source: https://docs.openlitespeed.org/config/advanced/uwsgi

Use a text editor with root privileges to create the service configuration file.

```bash
sudo vi /etc/systemd/system/example.service
```

--------------------------------

### Display systemctl help

Source: https://docs.openlitespeed.org/config/advanced/cgroups

Access the help documentation for the systemctl utility.

```bash
systemctl --help
```

--------------------------------

### Verify GeoIP database installation

Source: https://docs.openlitespeed.org/config/advanced/geolocation

Checks the installed GeoIP package to locate the database file path.

```bash
rpm -ql GeoIP
```

--------------------------------

### Initialize Flask Application

Source: https://docs.openlitespeed.org/config/appserver/python

Commands to create the application directory and the initial Flask application file.

```bash
mkdir app
```

```bash
vi /var/www/html/demo/app/__init__.py
```

--------------------------------

### Install Bubblewrap on CentOS 7

Source: https://docs.openlitespeed.org/config/advanced/bubblewrap

Install bubblewrap on CentOS 7 using the yum package manager.

```bash
sudo yum localinstall -y https://download-ib01.fedoraproject.org/pub/epel/testing/7/x86_64/Packages/b/bubblewrap-0.3.3-2.el7.x86_64.rpm
```

--------------------------------

### View lssetup help

Source: https://docs.openlitespeed.org/config/advanced/cgroups

Display the help menu for the lssetup utility to see available command line options.

```bash
/usr/local/lsws/lsns/bin/lssetup --h
```

--------------------------------

### Install Bubblewrap on CentOS 8

Source: https://docs.openlitespeed.org/config/advanced/bubblewrap

Install bubblewrap on CentOS 8 using the dnf package manager.

```bash
sudo dnf install -y https://ewr.edge.kernel.org/centos/8-stream/BaseOS/x86_64/os/Packages/bubblewrap-0.4.0-1.el8.x86_64.rpm
```

--------------------------------

### Install LiteSpeed ACME to Alternate Directory

Source: https://docs.openlitespeed.org/config/advanced/acme

Specify an alternative installation path using the -l switch.

```bash
/usr/local/lsws/admin/misc/install_acme.sh -l /usr/local/lsws2
```

--------------------------------

### Install Ruby Packages on CentOS

Source: https://docs.openlitespeed.org/config/appserver/ruby

Use yum to install the necessary Ruby packages on CentOS systems.

```bash
yum install ruby ruby-devel rubygems
```

--------------------------------

### Install ModSecurity via Repository

Source: https://docs.openlitespeed.org/modules/modsecurity

Commands to install the ModSecurity module package based on the operating system distribution.

```bash
yum install ols-modsecurity -y
```

```bash
apt-get install ols-modsecurity -y
```

--------------------------------

### Create Virtual Environment

Source: https://docs.openlitespeed.org/config/appserver/python

Commands to initialize a virtual environment, optionally specifying the Python version.

```bash
virtualenv venv
```

```bash
virtualenv -p python3 venv
```

--------------------------------

### Install PageSpeed Module via Package Manager

Source: https://docs.openlitespeed.org/modules/pagespeed

Commands to install the PageSpeed module using yum or apt-get.

```bash
yum install ols-pagespeed
```

```bash
apt-get install ols-pagespeed
```

--------------------------------

### Enable a site

Source: https://docs.openlitespeed.org/installation/cli

Command to enable a site at the server level.

```bash
ols site enable example.com
```

--------------------------------

### Install uWSGI dependencies on Linux

Source: https://docs.openlitespeed.org/config/advanced/uwsgi

Commands to install Python development tools and uWSGI packages on CentOS and Ubuntu systems.

```bash
yum install python3-devel
yum install python3-pip
yum install uwsgi
yum install uwsgi-plugin-python3
```

```bash
apt install build-essential
apt-get install python3-dev
apt-get install uwsgi
apt-get install uwsgi-plugin-python3
```

--------------------------------

### Install Python3 Development Packages on CentOS

Source: https://docs.openlitespeed.org/config/appserver/python

Commands to install Python 3 development headers and pip on CentOS systems.

```bash
yum install python3-devel
yum install python3-pip
```

```bash
yum install python36-devel
yum install python36-pip
```

--------------------------------

### Upgrade OpenLiteSpeed via Binary Install

Source: https://docs.openlitespeed.org/installation/upgrade

Use these commands to download, extract, and run the installation script for a specific version of OpenLiteSpeed.

```bash
wget https://openlitespeed.org/packages/openlitespeed-1.8.4.tgz
tar -zxvf openlitespeed-*.tgz
cd openlitespeed
./install.sh
```

--------------------------------

### Uninstall OpenLiteSpeed via Package Manager

Source: https://docs.openlitespeed.org/installation/upgrade

Use the system package manager to remove existing installations before switching to a different installation method.

```bash
yum
```

```bash
apt-get
```

--------------------------------

### Switch to Ghost User

Source: https://docs.openlitespeed.org/apps/ghost

Logs into the newly created user account.

```bash
su - demouser
```

--------------------------------

### Install OpenLiteSpeed as a reverse proxy for Langflow

Source: https://docs.openlitespeed.org/apps/langflow

Use the ols1clk script to automate the installation of OpenLiteSpeed, configure it as a reverse proxy for the Langflow service on port 7860, and enable AutoSSL for a specific domain.

```bash
bash <(curl -fsSL https://raw.githubusercontent.com/litespeedtech/ols1clk/master/ols1clk.sh) --proxy-r --proxy-port 7860 --autocert --sitedomain www.example.com
```
Tokens:
Raw