# 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.