Our auto-installer allows you to install LiteSpeed Web Server for use with cPanel/WHM with just one script. The auto-installation script installs LSWS and our WHM Plugin, registers your license (or requests a trial license), and builds PHP with LSAPI to match the current EasyApache-built PHP,
Prerequisites:
- This auto-installer can only be used for cPanel/WHM installations.
- Make sure beforehand that all sites are working fine with Apache. PHP must have been built with EasyApache.
- LiteSpeed will build its matching PHP (with LSAPI) based on this build of PHP.
Download:
The auto-installer script can be downloaded from the control panel plugins download page or with the following commands:
# wget https://www.litespeedtech.com/packages/cpanel/lsws_whm_autoinstaller.sh
We need to give permission to install the litespeed
# chmod a+x lsws_whm_autoinstaller.sh
Installation:
The following command is just to explain all the parameters that can be set during the installation process. If you would like a list of example commands please click
Prerequisites:
- This auto-installer can only be used for cPanel/WHM installations.
- Make sure beforehand that all sites are working fine with Apache. PHP must have been built with EasyApache.
- LiteSpeed will build its matching PHP (with LSAPI) based on this build of PHP.
Download:
The auto-installer script can be downloaded from the control panel plugins download page or with the following commands:
# wget https://www.litespeedtech.com/packages/cpanel/lsws_whm_autoinstaller.sh
We need to give permission to install the litespeed
# chmod a+x lsws_whm_autoinstaller.sh
Installation:
The following command is just to explain all the parameters that can be set during the installation process. If you would like a list of example commands please click
# ./lsws_whm_autoinstaller.sh SERIAL_NO [PHP_SUEXEC] [port_offset] [admin_user] [admin_pass] [admin_email] [easyapache_integration] [auto_switch_to_lsws]
Where all optional parameters have default values for convenience, but, for security reasons, we strongly recommend using your own values for all parameters. These parameters can be set as follows:
- (Required) SERIAL_NO: This will register the server using the serial number specified and retrieve a license key. Inputting TRIAL will cause a trial key to be requested and installed
- (Optional) PHP_SUEXEC: Available values are 0 (disable), 1 (enable), and 2 (user home directory only). Default value is 2.
- (Optional) port_offset: Controls the Apache port offset. This allows you to run LiteSpeed in parallel with Apache to test it out. For example, if you set port offset to 1000, Apache will continue
running on port 80 and LiteSpeed will run on port 1080. If port_offset is set to 0, LiteSpeed will be installed and set to use the same port Apache is currently using, but will not be automatically started after installation unless set to do so in a later parameter. When you are ready to replace Apache with LSWS as your main web server, simply stop Apache and start LiteSpeed (or use the Switch to LiteSpeed button in the WHM plugin). Default value is 1000.
-(Optional) admin_user: Admin username for accessing the LiteSpeed WebAdmin Console. Default value is admin.
- (Optional) admin_pass: Admin password for accessing the LiteSpeed WebAdmin Console. Default value is a1234567.
- (Optional) admin_email: Admin email. This email address will receive important server notices, such as license expiration and server core dumps. Default value is root@localhost.
- (Optional) easyapache_integration: EasyApache Integration, which is applied to EasyApache 3 only and is no longer applicable for EasyApache 4 as there is no need to “build a matching PHP” on EA4. For EasyApache 4, use the EA4 PHP rpms instead. Both 0 and 1 are valid values for EasyApache 4 LSWS installations. For EasyApache 3, easyapache_integration automatically rebuilds matching a PHP for LiteSpeed when you update EasyApache. Available values are 1 (enable) and 0 (disable). Default value is 1.
- (Optional) auto_switch_to_lsws: Automatically switch to LiteSpeed Web Server at the end of the installation. This setting will only take effect if the port offset is set to 0. Available values are 1 (enable) and 0 (disable). Most users will need to test and verify before they switch, so the default value is 0 (disabled).
Example:
# ./lsws_whm_autoinstaller.sh TRIAL 2 1000 admin 1234567 root@localhost 1 0
Note:
- If you install LSWS with a trial license, you can always switch to a purchased license using the “Change License” button in the WHM plugin.
- The auto-installer will build PHP for LSWS (with LSAPI) based on your most recent EasyApache PHP build.
- If CageFS was installed prior to using this script, the auto-installer will automatically add a mount point for LSWS.
- (Required) SERIAL_NO: This will register the server using the serial number specified and retrieve a license key. Inputting TRIAL will cause a trial key to be requested and installed
- (Optional) PHP_SUEXEC: Available values are 0 (disable), 1 (enable), and 2 (user home directory only). Default value is 2.
- (Optional) port_offset: Controls the Apache port offset. This allows you to run LiteSpeed in parallel with Apache to test it out. For example, if you set port offset to 1000, Apache will continue
running on port 80 and LiteSpeed will run on port 1080. If port_offset is set to 0, LiteSpeed will be installed and set to use the same port Apache is currently using, but will not be automatically started after installation unless set to do so in a later parameter. When you are ready to replace Apache with LSWS as your main web server, simply stop Apache and start LiteSpeed (or use the Switch to LiteSpeed button in the WHM plugin). Default value is 1000.
-(Optional) admin_user: Admin username for accessing the LiteSpeed WebAdmin Console. Default value is admin.
- (Optional) admin_pass: Admin password for accessing the LiteSpeed WebAdmin Console. Default value is a1234567.
- (Optional) admin_email: Admin email. This email address will receive important server notices, such as license expiration and server core dumps. Default value is root@localhost.
- (Optional) easyapache_integration: EasyApache Integration, which is applied to EasyApache 3 only and is no longer applicable for EasyApache 4 as there is no need to “build a matching PHP” on EA4. For EasyApache 4, use the EA4 PHP rpms instead. Both 0 and 1 are valid values for EasyApache 4 LSWS installations. For EasyApache 3, easyapache_integration automatically rebuilds matching a PHP for LiteSpeed when you update EasyApache. Available values are 1 (enable) and 0 (disable). Default value is 1.
- (Optional) auto_switch_to_lsws: Automatically switch to LiteSpeed Web Server at the end of the installation. This setting will only take effect if the port offset is set to 0. Available values are 1 (enable) and 0 (disable). Most users will need to test and verify before they switch, so the default value is 0 (disabled).
Example:
# ./lsws_whm_autoinstaller.sh TRIAL 2 1000 admin 1234567 root@localhost 1 0
Note:
- If you install LSWS with a trial license, you can always switch to a purchased license using the “Change License” button in the WHM plugin.
- The auto-installer will build PHP for LSWS (with LSAPI) based on your most recent EasyApache PHP build.
- If CageFS was installed prior to using this script, the auto-installer will automatically add a mount point for LSWS.
