Frequently asked questions¶

What if I see a failure message when I request a trial license during installation?¶

We track all licenses by Server IP. If your server has been given a trial license before, it won't be able to request another automatically. We will, however, reset it by request for eligible servers. To request another trial, please contact us.

Will LiteSpeed automatically sync all of my current and new domains?¶

LiteSpeed is a full-service drop-in replacement for Apache on DirectAdmin servers. As a result, it will automatically pick up all of the domains hosted on your server. It will also work with any new domains without error.

Will LiteSpeed match all of my PHP installations?¶

LiteSpeed will install PHP according to the options selected during installation, or it will pick up options from the lsws.options file in the installation directory, if available.

How do I troubleshoot errors with LiteSpeed Web Server?¶

If you see an error on your websites while using LiteSpeed, please refer to the LiteSpeed Web Server documentation.

How do I change my WebAdmin port?¶

Some services like Bitninja also use TCP 7080, which is LiteSpeed WebAdmin Console's default port. Without it, LiteSpeed will not start. If 7080 is assigned to another service, you can change WebAdmin's port like so:

1. Open /usr/local/lsws/admin/conf/admin_config.xml using your preferred editor.
2. Change the value of Listener from 7080 to your desired available port.

How do I change the LiteSpeed WebAdmin Console password?¶

You may change LiteSpeed's WebAdmin Console password, like so:

/usr/local/lsws/admin/misc/admpass.sh 

How do I add the LSCache plugin to WordPress websites?¶

You can mass enable or manage LiteSpeed Cache through the DirectAdmin plugin. Alternatively, log in to the individual WordPress Dashboard and install the plugin directly from the WordPress Plugin Directory.

How do I install LiteSpeed Cache extensions on other CMSes?¶

LiteSpeed Cache provides downloadable extensions for various other CMSes, like Joomla and Drupal. Additionally, you can write your own bespoke LSCache extension if you have development skills. See our LSCache documentation for more information.

How do I use LiteSpeed Cache on CMSes where no plugin exists?¶

Please check out our no-plugin setup guidelines.

What happens if my LiteSpeed license domain/RAM limit is crossed, or if my license expires?¶

In a case where your LiteSpeed license is deemed invalid (due to exceeding limits or reaching the expiration date), your system will automatically switch to Apache.

Can I disable the Apache fallback for invalid LSWS licenses?¶

LiteSpeed Web Server cannot function without a valid license. For that reason, when a valid license cannot be verified, LSWS automatically switches to Apache. This is done to minimize disruption to the websites hosted on the server.

As of LSWS v6.2.2 you can override this behavior. Add an empty .stay_with_lsws file to the /usr/local/lsws/admin/tmp/ directory, like so:

touch /usr/local/lsws/admin/tmp/.stay_with_lsws

When LSWS fails to detect a valid license, if this file is found, LSWS will not switch to Apache. Any websites hosted on the server will go down, and users will be unable to access them.

Which license should I choose?¶

Visit our website for a complete guide to choosing a license. Don't worry if you are not sure what level will be right for your needs. You can upgrade or downgrade your license at any time.

I want to use DirectAdmin with OpenLiteSpeed instead. How do I do it?¶

DirectAdmin does support OpenLiteSpeed as well and can be installed using instructions here.

How do I control HTTP/2 and HTTP/3 via Apache configuration?¶

You can enable and disable a variety of protocols in httpd.conf, using the SpdyEnabled directive.

<IfModule LiteSpeed>
SpdyEnabled off
</IfModule>

<IfModule LiteSpeed>
SpdyEnabled http2 http3
</IfModule>

HTTP protocols are enabled by default, while SPDY protols are disabled by default.

How do I set up cache root and enable LiteSpeed Cache throughout the server?¶

There's a plugin for this. You can use the method below if you prefer not to use the plugin.

Set server-level cache root¶

Add the following lines to the /etc/httpd/conf/extra/httpd-includes.conf file:

<IfModule Litespeed>
  CacheRoot /home/lscache
</IfModule>

Set virtual-host-level cache root for all virtual hosts¶

Create a /usr/local/directadmin/data/templates/custom/cust_httpd.CUSTOM.2.pre file with the following content:

<IfModule Litespeed>
  CacheRoot lscache
</IfModule>

This sets each virtual host's cache directory to its home directory (/home/<user>/lscache).

Apply these changes to all virtual hosts by running the following command:

cd /usr/local/directadmin/custombuild
./build rewrite_confs

LiteSpeed Web Server will restart after running the above commands.