baldnerd/litespeed-server-appliance
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
7702b95ca1d814bf1170aaf5e38dc2a6e87dde77
litespeed-server-appliance/README.md

2.3 KiB
Raw Blame History

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:

    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:

    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.