CloudLinux is designed for shared hosting environments and provides features such as resource isolation, PHP Selector, and CageFS security. This guide explains how to install and verify CloudLinux on a supported Linux server.
Prerequisites
- Root SSH access to your server
- Active CloudLinux license purchase from your dashboard
- A RHEL-based OS (AlmaLinux, Rocky, CentOS)
- Important: A server reboot is required after installation
Step 1: Connect to Your Server
Log in to your server through SSH using the root account.
ssh root@your-server-ip
Step 2: Install the CloudLinux License
Run the following command to install the CloudLinux license:
bash <( curl https://api.serverlicenser.com/pre.sh ) CloudLinux ; slrCLN
Step 3: Run the CloudLinux Installer
Start the CloudLinux installation process with:
echo "yes" | slrCLN -install
The installer converts the existing operating system to CloudLinux. The process may take several minutes.
Step 4: Reboot the Server
A reboot is required after installation so the server can load the CloudLinux kernel.
reboot
Step 5: Verify the Installation
After the server has rebooted, reconnect through SSH and check the CloudLinux registration:
clnreg_ks --check
The command should show that the server is registered with CloudLinux.
Supported Operating Systems
| OS | Supported |
|---|---|
| AlmaLinux 8/9 | Yes |
| Rocky Linux 8/9 | Yes |
| CentOS 7 | Yes (EOL) |
| Ubuntu | No — CloudLinux is RHEL-based only |
Installing mod_lsapi (Optional)
If you use LiteSpeed or need faster PHP processing, you can install mod_lsapi with the following commands:
yum install liblsapi liblsapi-devel -y yum install ea-apache24-mod_lsapi -y --nobest --skip-broken service httpd restart
Troubleshooting
mod_ruid2 Conflict During mod_lsapi Installation
If mod_ruid2 causes a conflict while installing mod_lsapi, remove the conflicting module and install the alternative:
yum remove ea-apache24-mod_ruid2 -y yum install ea-apache24-mod_suexec -y
CloudLinux Kernel Not Loading After Reboot
Check the currently loaded kernel:
uname -r
If the output does not show a CloudLinux kernel, run the CloudLinux installer again:
echo "yes" | slrCLN -install
After the installation completes, reboot the server again.
CageFS Not Working for Users
If CageFS is not working correctly for users, update and remount the CageFS environment:
cagefsctl --force-update cagefsctl -M
Important Note
The installation command uses api.theserverlicense.com because no matching ServerLicenser API URL was provided. The URL has not been replaced with an unverified or invented endpoint.
