Docs / Web Servers / How to Configure OpenLiteSpeed Web Server

How to Configure OpenLiteSpeed Web Server

By Admin · Mar 1, 2026 · Updated Apr 25, 2026 · 28 views · 2 min read

What Is OpenLiteSpeed?

OpenLiteSpeed is a high-performance, open-source web server that offers an event-driven architecture, built-in page caching, and a graphical admin interface. It is well-suited for hosting dynamic PHP applications on a Breeze with excellent resource efficiency.

Prerequisites

  • A Breeze running Ubuntu 22.04 or later
  • Root or sudo access
  • A domain name pointed to your Breeze

Step 1: Install OpenLiteSpeed

wget -O - https://repo.litespeed.sh | sudo bash
sudo apt install openlitespeed lsphp83 lsphp83-mysql lsphp83-curl lsphp83-common

Step 2: Set Admin Password

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

Enter your desired username and password for the web admin console.

Step 3: Access the Admin Panel

Open your browser and navigate to https://your-breeze-ip:7080. Log in with the credentials you just set.

Step 4: Configure a Virtual Host

In the admin panel:

  • Go to Virtual Hosts > Add
  • Set the Virtual Host Name and document root (e.g., /var/www/yourdomain)
  • Under Listeners, map port 80 to your virtual host
  • Set the PHP handler to lsphp83

Step 5: Enable Rewrite Rules

Under the virtual host settings, navigate to Rewrite and enable rewrite. Add your rules in the rewrite rules text area, just as you would with Apache .htaccess syntax.

Step 6: Restart the Server

sudo /usr/local/lsws/bin/lswsctrl restart

Performance Tips

  • Enable LiteSpeed Cache for dramatic speed improvements
  • Use the built-in .htaccess compatibility for easy migration from Apache
  • Monitor server stats from the admin panel under Dashboard

Was this article helpful?