How to Install & Automate SSL Certificates on LiteSpeed Using ACME

Prerequisites

• LiteSpeed Web Server installed (fresh install is fine)
• Shell access with sudo/root privileges
• DNS A/AAAA record pointing to this server
• Outbound internet access to your ACME Server URL (e.g., https://acme.sectigo.com/v2/DV)
• ACME SSL subscription with EAB credentials (EAB_KID and EAB_HMAC_KEY)
• HTTP Listener on port 80 for ACME validation (Verify in WebAdmin → Listeners → Port 80 is set to ANY; see Appendix for setup instructions)

Step 1: Install acme.sh

Install the acme.sh script to handle ACME SSL certificate issuance, installation, and renewal.

1. Install acme.sh

                                               curl https://get.acme.sh | sh
                                           

2. Load environment and verify

                                               source ~/.bashrc
                                               acme.sh --version
                                           

Step 2: Register your ACME Account

Register your ACME client using your EAB credentials to link it with your SSL provider.

                                    acme.sh --register-account \
                                    --server SERVER \
                                    --eab-kid EAB_KID \
                                    --eab-hmac-key EAB_HMAC_KEY \
                                    --accountemail you@example.com
                                        

Replace these placeholders with your own values:

• SERVER - The ACME server URL provided by your Certificate Authority.
• EAB_KID - The External Account Binding Key ID provided by your CA.
• EAB_HMAC_KEY - The EAB HMAC Key provided by your CA.
• you@example.com - Your email address for account registration and notifications.

Note: If the account already exists for these EAB credentials, acme.sh will reuse it.

Step 3: Issue the Certificate (Webroot Mode)

Run this command to issue your SSL certificate via the webroot method:

                                    acme.sh --issue \
                                      -d yourdomain.com \
                                      -w /path/to/webroot \
                                    --server SERVER
                                        

Replace these placeholders with your own values:

• yourdomain.com - Your actual domain name.
• /path/to/webroot - The document root path of your website.
• SERVER - The ACME server URL provided by your CA, eg https://acme.sectigo.com/v2/DV

Step 4: Install SSL Certificate

Install the issued certificate and key into LiteSpeed and configure it to reload automatically after renewal.

1. Create Certificate Directory

                                               mkdir -p /usr/local/lsws/conf/cert/yourdomain.com

2. Install Certificate & Reload LiteSpeed

                                               acme.sh --install-cert -d yourdomain.com \
                                             --key-file       /usr/local/lsws/conf/cert/yourdomain.com/yourdomain.com.key \
                                             --fullchain-file /usr/local/lsws/conf/cert/yourdomain.com/yourdomain.com.crt \
                                             --reloadcmd     "/usr/local/lsws/bin/lswsctrl reload"

   Tip: LiteSpeed will reload automatically after each renewal.

   Replace yourdomain.com with the domain you will use for the SSL certificate.

   
   Image Caption: File browser/terminal showing the key and certificate under LightSpeed’s certificate directory: /usr/local/lsws/conf/cert/yourdomain.com/
   Tips: If LiteSpeed doesn’t reload with new cert, confirm --reloadcmd path is correct. Check file ownership/permissions under /usr/local/lsws/conf/cert/.

3. Add HTTPS Listener on Port 443 (if not already set up)

   Create the TLS listener after you have certificate files in place.

   1. Go to WebAdmin → Listeners → Add
   2. Set:
      • Name: HTTPS
      • IP Address: ANY
      • Port: 443
      • Secure: Yes
      

4. Under SSL tab, set:

   • Private Key File: /usr/local/lsws/conf/cert/yourdomain.com/yourdomain.com.key
   • Certificate File: /usr/local/lsws/conf/cert/yourdomain.com/yourdomain.com.crt
   
   Image Caption: iteSpeed WebAdmin HTTPS listener configuration with private key and certificate file paths set.

5. Map your virtual host (e.g., Example) to domain *.

   

6. Save and Restart LiteSpeed.

Step 5: Verify Installation & Auto-Renewal

ACME.sh will automatically renew your SSL certificate about 30 days before it expires. It’s a good idea to test auto-renewal now to make sure your server is correctly configured for it to run.

1. Verify the SSL Installation

   Visit https://yourdomain.com and confirm:

   • Site loads over HTTPS
   • Certificate is valid and matches your domain

2. Check Cron Setup

                                               crontab  -l

   Typical entry looks like:

                                               24 13 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null

3. Test Renewal Manually

                                               acme.sh --renew -d yourdomain.com --force

   Replace yourdomain.com with the domain you will use for the SSL certificate.

   
   Image Caption: Terminal showing crontab -l with the acme.sh cron entry
   Troubleshooting: If SSL monitor shows expired cert, confirm cron ran and LSWS reloaded. Clear CDN cache if changes don’t show.

Appendix: HTTP Listener & ACME Path Verification

1. Configure the HTTP listener (port 80)

   This step prepares your LiteSpeed server for SSL certificate automation by enabling it to properly respond to ACME HTTP-01 validation requests on port 80, which is required for certificate issuance.

   1. Sign in to LiteSpeed WebAdmin: https://<SERVER-IP>:7080
   2. Go to Listeners → Default (this exists on fresh installs).
   3. Set:
      • Port = 80
      • IP = ANY
   4. Save and Restart LiteSpeed.
   5. On fresh installs, the Example virtual host is already mapped to this listener by default, with a wildcard domain (*) to handle all incoming HTTPS requests.
   
   Image Caption: LiteSpeed WebAdmin showing the Default Listener configured on Port 80 with IP set to ANY, ready for ACME SSL validation.
   Note: You do not need to bind a specific domain for HTTP validation. Using the wildcard (*) in the virtual host is sufficient for ACME validation, as it allows all subdomains to pass HTTP-01 challenges automatically.
   Troubleshooting: If port 80 is blocked or conflicting with another service, run:
   sudo lsof -i :80
   to find the process using it, stop that process, and restart LiteSpeed.

2. Verify ACME Path is Reachable (Optional)

   Before requesting your SSL certificate, confirm that the ACME challenge directory (/.well-known/acme-challenge/) is accessible via HTTP from your webroot. This helps prevent validation failures during issuance.

   1. Confirm your OS/distro

                                                          cat /etc/lsb-release

      This helps you confirm your environment (Ubuntu/Debian/CentOS, etc.) before working with the LiteSpeed webroot.

   2. Create the ACME challenge directory and test file

                                                          cd /usr/local/lsws/Example/html
                                                          mkdir -p /usr/local/lsws/Example/html/.well-known/acme-challenge
                                                          echo "Welcome test" > /usr/local/lsws/Example/html/.well-known/acme-challenge/testfile
      

   3. Verify with curl

                                                          curl http://yourdomain.com/.well-known/acme-challenge/testfile

      yourdomain.com - Your actual domain name. Replace with the domain you will use for the SSL certificate.

      
      Image Caption: Verifying ACME HTTP challenge directory setup on LiteSpeed by creating and accessing a test file.

      
      If you force redirect HTTP→HTTPS, add an exception so ACME files stay on HTTP:

      # cat /usr/local/lsws/Example/html/.htaccess

                                                          RewriteEngine On
                                                      # If HTTPS is not already on, redirect to HTTPS
                                                          RewriteCond %{HTTPS} !=on
                                                      RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
                                                      

      
      Image Caption: Verifying ACME HTTP-01 challenge directory accessibility on LiteSpeed by creating and successfully retrieving a test file over HTTP.
      Note: Ensure port 80 is open in OS firewall and any cloud security group/WAF/CDN in front of the server.
      Troubleshooting: If curl test fails, check file permissions under .well-known/acme-challenge/. Ensure no HTTPS redirect is applied for ACME path.

Quick Fixes

• 404 on challenge file → Re check Step 1.5 path and permissions; ensure .htaccess exception exists; confirm listener is on port 80 and security groups/firewalls allow port 80.
• Unauthorized / Not Delegated → Ensure Step 3 used the Sectigo directory URL and the correct EAB for this CaaS subscription/domain.
• /usr/local/lsws/Example/html does not contain DNS → Informational message from acme.sh when using webroot; safe to ignore.
• Port 80 blocked / conflicting → Verify nothing else is bound to port 80; sudo lsof -i :80; fix and restart LSWS.
• Standalone mode conflicts → Avoid --standalone when LiteSpeed is running; use --webroot mode instead.

Summary

You’ve successfully:

• Registered your ACME account with EAB credentials
• Issued and installed an SSL certificate
• Configured LiteSpeed to reload automatically after renewal

Your SSL certificates will now renew automatically with no manual intervention.