74 lines
2.3 KiB
Markdown
74 lines
2.3 KiB
Markdown
# LiteSpeed Server Appliance
|
||
|
||
An Open Source Appliance from Robbie Ferguson
|
||
(c) 2025 Robbie Ferguson – Licensed under Apache 2.0
|
||
|
||
## Overview
|
||
|
||
The LiteSpeed Server Appliance is a fast, modern web server environment built on:
|
||
|
||
* **OpenLiteSpeed** for blazing-fast HTTP/3-powered web serving
|
||
* **MariaDB** for robust, MySQL-compatible databases
|
||
* **PHP 8.3** and essential extensions
|
||
* **Redis**, GZIP, and Brotli for performance and caching
|
||
* **Self-signed SSL** out of the box, with **Let's Encrypt support via Certbot**
|
||
|
||
It's perfect for hosting WordPress or other high-performance websites and apps on
|
||
low-powered hardware such as Raspberry Pi.
|
||
|
||
---
|
||
|
||
## Default Settings
|
||
|
||
* Web Root: `/var/www/html`
|
||
* WebAdmin Panel: `https://your-server-ip:7080`
|
||
|
||
* Set admin password: `/usr/local/lsws/admin/misc/admpass.sh` (as root)
|
||
* Web View: `https://your-server/`
|
||
* UFW Firewall: Enabled (Ports 22, 80, 443, 7080 allowed)
|
||
* php.ini is located at /usr/local/lsws/lsphp83/etc/php/83/litespeed/php.ini
|
||
|
||
---
|
||
|
||
## SSL Setup
|
||
|
||
### ✅ Configured Out-of-the-box
|
||
|
||
* A **self-signed SSL certificate** is preinstalled and active for your site on port 443.
|
||
* This lets you test HTTPS immediately with a browser security exception.
|
||
|
||
### 🔒 Upgrade to Let's Encrypt SSL (Recommended)
|
||
|
||
1. Let's Encrypt certbot is already installed and ready.
|
||
2. Ensure your domain points to this server.
|
||
3. Run:
|
||
|
||
```bash
|
||
certbot certonly --webroot -w /var/www/html -d yourdomain.com
|
||
```
|
||
4. Update LiteSpeed's config to use the real cert:
|
||
|
||
```
|
||
certFile /etc/letsencrypt/live/yourdomain.com/fullchain.pem
|
||
keyFile /etc/letsencrypt/live/yourdomain.com/privkey.pem
|
||
```
|
||
5. Restart LiteSpeed:
|
||
|
||
```bash
|
||
systemctl restart lsws
|
||
```
|
||
|
||
---
|
||
|
||
## Notes
|
||
|
||
* The appliance does **not** include WordPress or any CMS by default. Install your web site or CMS to /var/www/html/
|
||
* All configuration happens during the build phase. End users can begin using the server immediately.
|
||
* File uploads, rewrite rules, caching behavior, and database settings can be optimized, but editing of defaults via LiteSpeed WebAdmin or php.ini is entirely open.
|
||
|
||
---
|
||
|
||
## Support & Licensing
|
||
|
||
This appliance is open source and released under the **Apache 2.0 license**. Use at your own risk. Contributions and forks are welcome.
|