OpenLiteSpeed WordPress Docker Container

Install a Lightweight WordPress container with OpenLiteSpeed [Edge / Stable] version based on Ubuntu 18.04 Linux.

Prerequisites

1. Install Docker
2. Install Docker Compose
3. Clone this repository or copy the files from this repository into a new folder:

git clone https://github.com/litespeedtech/ols-docker-env.git

Configuration

Edit the .env file to update the demo site domain, default MySQL user, and password.

Installation

Open a terminal, cd to the folder in which docker-compose.yml is saved, and run:

docker-compose up

Components

The docker image installs the following packages on your system:

Component	Version
Linux	Ubuntu 18.04
OpenLiteSpeed	Latest version
MariaDB	Stable version: 10.3
PHP	Stable version: 7.4
LiteSpeed Cache	Latest from WordPress.org
ACME	Latest from ACME official
WordPress	Latest from WordPress
phpMyAdmin	Latest from dockerhub

Data Structure

Cloned project

├── acme
├── bin
│   └── container
├── data
│   └── db
├── logs
│   ├── access.log
│   ├── error.log
│   ├── lsrestart.log
│   └── stderr.log
├── lsws
│   ├── admin-conf
│   └── conf
└── sites
│   └── localhost
├── LICENSE
├── README.md
├── docker-compose.yml

• acme contains all applied the cert from Lets Encrypt
• bin contains multiple cli scripts to allow you add/del VH, install applications, upgrade ..etc
• data Stores mysql db
• logs contains all the webserver logs and virtual host access logs
• lsws contains all web server config files
• sites contains the Document root (the WordPress application will install here)

Usage

Starting a Container

Start the container with the up or start methods:

docker-compose up

You can run with daemon mode, like so:

docker-compose up -d

The container is now built and running.

Stopping a Container

docker-compose stop

Removing Containers

To stop and remove all containers, use the down command:

docker-compose down

Setting the WebAdmin Password

We strongly recommend you set your personal password right away.

bash bin/webadmin.sh MYPASSWORD

Starting a Demo Site

After running the following command, you should be able to access the WordPress installation with the configured domain. By default the domain is https://localhost and https://server_IP.

bash bin/demosite.sh

Creating a Domain and Virtual Host

bash bin/domain.sh [-add|-a] example.com

Deleting a Domain and Virtual Host

bash bin/domain.sh [-del|-d] example.com

Creating a Database

You can either automatically generate the user, password, and database names, or specify them. Use the following to auto generate:

bash bin/database.sh [-domain|-d] example.com

Use this command to specify your own names, substituting user_name, my_password, and database_name with your preferred values:

bash bin/database.sh [-domain|-d] example.com [-user|-u] user_name [-password|-p] my_password [-database|-db] database_name

Installing a WordPress Site

To preconfigure the wp-config file, run the database.sh script for your domain, before you use the following command to install WordPress:

./bin/appinstall.sh [-app|-a] wordpress [-domain|-d] example.com

Install ACME

We need to run amce installation command at first time only.

• With email notification

./bin/acme.sh [--install|-i] [--email|-e] EMAIL_ADDR

• Without email notification

./bin/acme.sh [--install|-i] [--no-email|-ne]

Applying a Let's Encrypt Certificate

Use the root domain in this command, and it will check for a certificate and automatically apply one with and without www:

./bin/acme.sh [-domain|-d] example.com

Update Web Server

To upgrade web server to latest stable version, run

bash bin/webadmin.sh [-lsup|-upgrade]

Apply OWASP ModSecurity

Enable OWASP mod_secure on web server, run

bash bin/webadmin.sh [-modsec|-sec] enable

Disable OWASP mod_secure on web server, run

bash bin/webadmin.sh [-modsec|-sec] disable

Accessing the Database

After installation, you can use phpMinAdmin to access the database by visiting http://127.0.0.1:8080 or https://127.0.0.1:8443. The default username is root, and the password is the same as the one you supplied in the .env file.

Support & Feedback

If you still have a question after using OpenLiteSpeed Docker, you have a few options.

• Join the GoLiteSpeed Slack community for real-time discussion
• Post to the OpenLiteSpeed Forums for community support
• Reporting any issue on Github ols-docker-env project

Pull requests are always welcome