What is CyberPanel Custom OpenLiteSpeed?

CyberPanel maintains a custom-built OpenLiteSpeed binary that includes enhancements not available in the stock version from LiteSpeed Technologies. This custom binary is free and installed automatically with CyberPanel.

Important: The custom OpenLiteSpeed binary is a separate product from the .htaccess Module. Understanding the difference between these products is essential before purchasing.

Three Products — Know the Difference

CyberPanel offers three distinct OpenLiteSpeed-related products:

	Custom OLS Binary	.htaccess Module	OLS for Any Panel
What it is	Modified OpenLiteSpeed server binary with patches	Add-on module (cyberpanel_ols.so) that processes Apache .htaccess files	Complete Apache-to-OLS replacement package for Plesk/cPanel (includes custom binary + Apache config auto-parser)
Price	Free (included with CyberPanel)	$59/year or $199 lifetime	Free (open source, GPLv3)
Target	CyberPanel users	Any OLS user on any panel	Plesk & cPanel users replacing Apache
PHPConfig LSIAPI hooks	Yes	—	Yes (same custom binary)
Origin header forwarding	Yes	—	Yes
Static linking	Yes	—	Yes
ModSecurity ABI compat	Yes	—	Yes
ReadApacheConf (auto-parses existing Apache configs)	No	No	Yes — reads Apache vhosts and creates OLS configs automatically
Apache .htaccess processing	No	Yes — headers, redirects, access control, PHP directives, error docs, expires, FilesMatch, SetEnv	No (purchase .htaccess Module separately)
WordPress brute force protection	No	Yes	No (included with .htaccess Module)
License required	No	Yes (key-based)	No

In plain terms:

• Custom OLS Binary = The server engine itself, with patches for PHPConfig, CORS/Origin support, static linking, and ModSecurity compatibility. Installed automatically with CyberPanel. Free.
• .htaccess Module = A paid add-on that teaches OpenLiteSpeed how to read Apache .htaccess files — including headers, redirects, PHP values (php_value/php_flag), access control, brute force protection, and more. Works on any panel (CyberPanel, Plesk, cPanel, standalone). $59/year or $199 lifetime. See installation & activation guide.
• OLS for Any Panel = A free installer for Plesk and cPanel users. It installs our custom OLS binary and adds ReadApacheConf — a tool that automatically reads your existing Apache configurations and creates matching OLS virtual hosts. All your sites work immediately without manual migration. The .htaccess module can be purchased separately for full .htaccess support. Register free.

---

Custom OLS Binary — What’s Inside

1. PHPConfig Support

Five patches are applied to the OLS source code to add LSIAPI hooks for PHP configuration handling. When paired with the .htaccess Module, this enables php_value and php_flag directives in .htaccess files.

2. Origin Header Forwarding

Properly forwards the Origin header in reverse proxy setups. Fixes “Connection Lost” errors in modern applications like n8n (v1.87.0+) that validate the Origin header.

3. Static Linking

Statically linked against libstdc++ and libgcc, eliminating GLIBC version dependency issues. One binary works across Ubuntu 20.04–24.04 and RHEL/AlmaLinux 8.x–9.x.

4. ModSecurity ABI Compatibility

A matching ModSecurity module is built against the same OLS headers. Never mix stock and custom binaries — custom OLS requires the custom ModSecurity module to avoid segfaults and 503 errors.

---

Supported Operating Systems

OS	Version	Binary	Status
Ubuntu	20.04, 22.04, 24.04	ubuntu-static	Fully Supported
Debian	12+	ubuntu-static	Fully Supported
AlmaLinux / Rocky Linux	8.x	rhel8-static	Fully Supported
AlmaLinux / Rocky Linux	9.x	rhel9-static	Fully Supported
RHEL	8.x, 9.x	rhel8-static / rhel9-static	Fully Supported
CloudLinux	8.x	rhel8-static	Fully Supported

Supported Control Panels

Panel	Custom OLS Binary	.htaccess Module ($59/yr)	OLS for Any Panel (Free)
CyberPanel	Auto-installed on upgrade	Available (paid)	N/A
Plesk	Included via OLS for Any Panel	Available (paid)	Full support
cPanel / WHM	Included via OLS for Any Panel	Available (paid)	Full support
Standalone (no panel)	Manual install	Available (paid)	N/A

---

Installation

CyberPanel Users (Automatic)

The custom OLS binary is installed automatically during CyberPanel upgrades:

sh <(curl https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh)

CyberPanel auto-detects your OS, downloads the correct binary, verifies SHA256 checksums, and installs it.

Plesk & cPanel Users (OLS for Any Panel — Free)

1. Register at platform.cyberpersons.com/cyberpanel/openlitespeed/
2. Receive install/uninstall commands via email
3. Run one command on your server — Apache is replaced with zero downtime
4. All existing sites work immediately (ReadApacheConf auto-parses Apache configs)

One command to install, one command to revert to Apache. No license keys. Optionally purchase the .htaccess Module for full .htaccess support. After installation, install the cPanel/WHM Management Plugin for a graphical interface to manage OLS, PHP, and cache.

Manual Installation (Advanced)

For standalone servers or custom setups, three files are installed:

File	Purpose	Destination
openlitespeed-phpconfig-x86_64-*-static	Custom OLS binary	/usr/local/lsws/bin/openlitespeed
cyberpanel_ols_x86_64_*.so	.htaccess module (requires license)	/usr/local/lsws/modules/cyberpanel_ols.so
mod_security-compatible-*.so	ModSecurity module	/usr/local/lsws/modules/mod_security.so

Ubuntu / Debian

cd /tmp
wget -q https://cyberpanel.net/openlitespeed-phpconfig-x86_64-ubuntu-static
wget -q https://cyberpanel.net/cyberpanel_ols_x86_64_ubuntu.so
wget -q https://cyberpanel.net/mod_security-compatible-ubuntu.so
wget -q https://cyberpanel.net/SHA256SUMS_UBUNTU

sha256sum -c SHA256SUMS_UBUNTU --ignore-missing

/usr/local/lsws/bin/lswsctrl stop
cp /usr/local/lsws/bin/openlitespeed /usr/local/lsws/bin/openlitespeed.backup.$(date +%s)

cp openlitespeed-phpconfig-x86_64-ubuntu-static /usr/local/lsws/bin/openlitespeed
cp cyberpanel_ols_x86_64_ubuntu.so /usr/local/lsws/modules/cyberpanel_ols.so
cp mod_security-compatible-ubuntu.so /usr/local/lsws/modules/mod_security.so
chmod 755 /usr/local/lsws/bin/openlitespeed /usr/local/lsws/modules/*.so

/usr/local/lsws/bin/lswsctrl start

RHEL 9 / AlmaLinux 9 / Rocky Linux 9

cd /tmp
wget -q https://cyberpanel.net/openlitespeed-phpconfig-x86_64-rhel9-static
wget -q https://cyberpanel.net/cyberpanel_ols_x86_64_rhel.so
wget -q https://cyberpanel.net/mod_security-compatible-rhel.so
wget -q https://cyberpanel.net/SHA256SUMS_RHEL9

sha256sum -c SHA256SUMS_RHEL9 --ignore-missing

/usr/local/lsws/bin/lswsctrl stop
cp /usr/local/lsws/bin/openlitespeed /usr/local/lsws/bin/openlitespeed.backup.$(date +%s)

cp openlitespeed-phpconfig-x86_64-rhel9-static /usr/local/lsws/bin/openlitespeed
cp cyberpanel_ols_x86_64_rhel.so /usr/local/lsws/modules/cyberpanel_ols.so
cp mod_security-compatible-rhel.so /usr/local/lsws/modules/mod_security.so
chmod 755 /usr/local/lsws/bin/openlitespeed /usr/local/lsws/modules/*.so

/usr/local/lsws/bin/lswsctrl start

RHEL 8 / AlmaLinux 8 / Rocky Linux 8

cd /tmp
wget -q https://cyberpanel.net/openlitespeed-phpconfig-x86_64-rhel8-static
wget -q https://cyberpanel.net/cyberpanel_ols_x86_64_rhel8.so
wget -q https://cyberpanel.net/mod_security-compatible-rhel8.so
wget -q https://cyberpanel.net/SHA256SUMS_RHEL8

sha256sum -c SHA256SUMS_RHEL8 --ignore-missing

/usr/local/lsws/bin/lswsctrl stop
cp /usr/local/lsws/bin/openlitespeed /usr/local/lsws/bin/openlitespeed.backup.$(date +%s)

cp openlitespeed-phpconfig-x86_64-rhel8-static /usr/local/lsws/bin/openlitespeed
cp cyberpanel_ols_x86_64_rhel8.so /usr/local/lsws/modules/cyberpanel_ols.so
cp mod_security-compatible-rhel8.so /usr/local/lsws/modules/mod_security.so
chmod 755 /usr/local/lsws/bin/openlitespeed /usr/local/lsws/modules/*.so

/usr/local/lsws/bin/lswsctrl start

---

Verification

# Check OLS is running
/usr/local/lsws/bin/openlitespeed -v

# Verify static linking (should return empty)
ldd /usr/local/lsws/bin/openlitespeed | grep -E "libstdc\+\+|libgcc"

# Check service status
systemctl status lshttpd

---

Upgrading from Stock OpenLiteSpeed

1. Take a snapshot/backup of your server
2. Stop OLS: /usr/local/lsws/bin/lswsctrl stop
3. Backup: cp /usr/local/lsws/bin/openlitespeed /usr/local/lsws/bin/openlitespeed.backup
4. Install custom binary and modules (see Manual Installation above)
5. Start OLS: /usr/local/lsws/bin/lswsctrl start

Existing vhost configs, SSL certificates, and PHP settings are preserved.

---

Troubleshooting

GLIBC version errors

./litespeed: /lib/x86_64-linux-gnu/libc.so.6: version 'GLIBC_2.33' not found

You’re using a dynamically linked binary. Download the correct static-linked binary for your OS.

ModSecurity causes 503 errors or segfaults

ABI mismatch. Install the matching mod_security-compatible-*.so from cyberpanel.net.

N8N “Connection Lost” errors

Missing Origin header forwarding. Upgrade to the custom OLS binary.

OLS fails to start

cat /usr/local/lsws/logs/error.log
/usr/local/lsws/bin/openlitespeed -t
systemctl restart lsws

---

Getting Help

• Support: [email protected]
• Knowledge Base: cyberpanel.net/KnowledgeBase
• Forums: forums.cyberpanel.net
• Purchase .htaccess Module: $59/year or $199 lifetime
• .htaccess Module Installation Guide: Installing & Activating the .htaccess Module
• cPanel/WHM Plugin Guide: Managing OpenLiteSpeed on cPanel
• Register OLS for Any Panel (free): platform.cyberpersons.com