Skip to content

OpenLiteSpeed

Install a lightweight OpenLiteSpeed container using either the Edge or Stable version in Ubuntu 24.04 Linux.

Prerequisites

Build Components

The system will regulary build both OpenLiteSpeed Edge and Latest stable versions, along with the last two PHP versions.

Component Version
Linux Ubuntu 24.04
OpenLiteSpeed Latest stable version
PHP Latest stable version

Usage

Download an image

Download the OpenLiteSpeed image. You can use latest for the latest version:

docker pull litespeedtech/openlitespeed:latest
docker pull ghcr.io/ndigitals/openlitespeed:latest

Or use a specific OpenLiteSpeed version and lsphp version:

docker pull litespeedtech/openlitespeed:1.8.2-lsphp83
docker pull ghcr.io/ndigitals/openlitespeed:1.7.16-lsphp81

Note

The ARM64 repo and image are contributed and maintained by ndigitals.

Start a Container

docker run --name openlitespeed -p 7080:7080 -p 80:80 -p 443:443 -it litespeedtech/openlitespeed:latest
docker run --name openlitespeed -p 7080:7080 -p 80:80 -p 443:443 -it ghcr.io/ndigitals/openlitespeed:latest

You can also run with Detached mode, like so:

docker run -d --name openlitespeed -p 7080:7080 -p 80:80 -p 443:443 -it litespeedtech/openlitespeed:latest
docker run -d --name openlitespeed -p 7080:7080 -p 80:80 -p 443:443 -it ghcr.io/ndigitals/openlitespeed:latest

Tip

You can eliminate -p 7080:7080 from the command if you don’t need WebAdmin access.

Add a sample page

The server should start running successfully, and you should be able to log into the container. Add some files you want to display with the following command:

docker exec -it openlitespeed bash

Your default WORKDIR should be /var/www/vhosts/, since the default document root path is /var/www/vhosts/localhost/html. Simply add the following command to index.php, then we can verify it from the browser with a public server IP address on both HTTP and HTTPS.

echo '<?php phpinfo();' > localhost/html/index.php

Stop a Container

Feel free to substitute the "openlitespeed" to the "Container_ID" if you did not define any name for the container.

docker stop openlitespeed

Customization

Sometimes you may want to install more packages from the default image, or some other web server or PHP version which is not officially provided. You can build an image based on an existing image. Here’s how: 1. Download the dockerfile project 2. cd into the project directory 3. Edit the Dockerfile here if necessary 4. Build, feeling free to substitute server and PHP versions to fit your needs

For example:

git clone https://github.com/litespeedtech/ols-dockerfiles.git
cd ols-dockerfiles/template
bash build.sh -L 1.8.2 -P lsphp83