Table of Contents

Troubleshooting LiteSpeed Web Server with cPanel/WHM

This wiki will address problems that may occur on a LiteSpeed Web Server/WHM installation. The installation process is covered in our Auto-Installer wiki.

Note: For free support of LSWS please use the LiteSpeed forum. If you have an issue with cPanel (even while using LSWS) please contact cPanel support. They are fully trained to handle LiteSpeed Web Server.

Insufficient Process Memory

Insufficient process memory may result in the following error messages (when you try to build matching PHP):

Found Errors

ERROR: /usr/local/bin/php -i returns 6 

You can try to build matching PHP from command line: 
"/usr/local/cpanel/whostmgr/cgi/lsws/cmd_buildmatchingphp.sh"

or

Found Errors

ERROR: /usr/local/bin/php -i returns 134

You can try to build matching PHP from command line: 
"/usr/local/cpanel/whostmgr/cgi/lsws/cmd_buildmatchingphp.sh"

To fix this, try increasing the Max cPanel process memory (Minimum: 512) in WHM > Server Configuration > Tweak Settings.

LiteSpeed Does Not Restart When Configuration Changes

In order for configuration changes to take effect, LiteSpeed Web Server should restart automatically. Do NOT uncheck the httpd service under WHM > Service Configuration > Service Manager. If unchecked, WHM will not restart LiteSpeed automatically when configurations have been changed.

Incorrect gcc Permissions

cPanel may set permissions for /usr/bin/gcc to 0700. This will break our PHP build script. To fix this, change the permissions for the directory:

chmod 0755 /usr/bin/gcc

After finishing your PHP build, you can change permissions back:

chmod 0700 /usr/bin/gcc

mod_lsapi Incompatibility

LSWS is not compatible with mod_lsapi so we recommend disabling it before installing LiteSpeed. All the functionality that mod_lsapi offers is already built directly inside of LSWS, so mod_lsapi is unnecessary, and in fact may cause issues and performance decreases.

Unexplained site downtime

If you have sites experiencing unexplained downtime, and you are using a proxy shield (such as CloudLinux Imunify360) we recommend disabling the shield. If the downtime ceases, then this is likely not a LiteSpeed or cPanel issue. Please contact the proxy shield software's support team.