Install a Lightweight WordPress container with LiteSpeed stable version based on Ubuntu 22.04 Linux.
Edit the .env file to update the demo site domain, default MySQL user, and password.
Feel free to check Docker hub Tag page if you want to update default litespeed and php versions.
Clone this repository or copy the files from this repository into a new folder:
git clone https://github.com/litespeedtech/lsws-docker-env.git
Open a terminal, cd to the folder in which docker-compose.yml is saved, and run:
docker compose up
Note: If you wish to run a single web server container, please see the usage method here.
The docker image installs the following packages on your system:
| Component | Version |
|---|---|
| Linux | Ubuntu 22.04 |
| LiteSpeed | Latest version |
| MariaDB | Stable version: 10.5 |
| PHP | Latest version |
| LiteSpeed Cache | Latest from WordPress.org |
| ACME | Latest from ACME official |
| WordPress | Latest from WordPress |
| phpMyAdmin | Latest from dockerhub |
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-
acmecontains all applied certificates from Lets Encrypt -
bincontains multiple CLI scripts to allow you add or delete virtual hosts, install applications, upgrade, etc -
datastores the MySQL database -
logscontains all of the web server logs and virtual host access logs -
lswscontains all web server configuration files -
sitescontains the document roots (the WordPress application will install here)
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.
Note: The container will auto-apply a 15-day trial license. Please contact LiteSpeed to extend the trial, or apply your own license, starting from $0.
docker compose stop
To stop and remove all containers, use the down command:
docker compose down
We strongly recommend you set your personal password right away.
bash bin/webadmin.sh my_password
After running the following command, you should be able to access the WordPress installation with the configured domain. By default the domain is http://localhost.
bash bin/demosite.sh
bash bin/domain.sh [-A, --add] example.com
Please ignore SSL certificate warnings from the server. They happen if you haven't applied the certificate.
bash bin/domain.sh [-D, --del] example.com
You can either automatically generate the user, password, and database names, or specify them. Use the following to auto generate:
bash bin/database.sh [-D, --domain] 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 [-D, --domain] example.com [-U, --user] USER_NAME [-P, --password] MY_PASS [-DB, --database] DATABASE_NAME
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 [-A, --app] wordpress [-D, --domain] example.com
We need to run the ACME installation command the first time only. With email notification:
./bin/acme.sh [-I, --install] [-E, --email] EMAIL_ADDR
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 [-D, --domain] example.com
To upgrade the web server to latest stable version, run the following:
bash bin/webadmin.sh [-U, --upgrade]
Enable OWASP mod_secure on the web server:
bash bin/webadmin.sh [-M, --mod-secure] enable
Disable OWASP mod_secure on the web server:
bash bin/webadmin.sh [-M, --mod-secure] disable
Please ignore ModSecurity warnings from the server. They happen if some of the rules are not supported by the server.
Apply your license with command:
bash bin/webadmin.sh [-S, --serial] YOUR_SERIAL
Apply trial license to server with command:
bash bin/webadmin.sh [-S, --serial] TRIAL
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.
If you want to customize the image by adding some packages, e.g. lsphp74-pspell, just extend it with a Dockerfile.
- We can create a
customfolder and acustom/Dockerfilefile under the main project. - Add the following example code to
Dockerfileunder the custom folder
FROM litespeedtech/litespeed:latest
RUN apt-get update && apt-get install lsphp74-pspell
- Add
build: ./customline under the "image: litespeedtech" of docker-compose file. So it will looks like this
litespeed:
image: litespeedtech/litespeed:${LSWS_VERSION}-${PHP_VERSION}
build: ./custom
- Build and start it with command:
docker compose up --build
If you still have a question after using LiteSpeed Docker, you have a few options.
- Join the GoLiteSpeed Slack community for real-time discussion
- Post to the LiteSpeed Forums for community support
- Reporting any issue on Github lsws-docker-env project
Pull requests are always welcome
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent