CXS (ConfigServer eXploit Scanner) scans uploaded files and server data to identify malware, exploits, and suspicious scripts. This guide explains how to install and verify CXS on a cPanel server.
Prerequisites
- Root SSH access to your server
- An active CXS license purchased from your dashboard
- cPanel installed on your server
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 and Activate CXS
Run the following command to install and activate the CXS license:
bash <( curl https://api.serverlicenser.com/pre.sh ) CXS ; slrCXS
Step 3: Verify the Installation
After installation, check the installed CXS version with:
/usr/local/cpanel/3rdparty/bin/perl /etc/cxs/cxs.pl --version
The command should return the installed CXS version, confirming that CXS is available on the server.
Important: AlmaLinux 9 and OpenSSL 3.x
If your server is running AlmaLinux 9 or another operating system using OpenSSL 3.x, the standard CXS activation process may encounter a compatibility issue.
In this situation, use the following alternative command:
slrCXS
Supported Operating Systems
| OS | Supported | Notes |
|---|---|---|
| AlmaLinux 8 | Yes | Standard installation |
| AlmaLinux 9 | Yes | Use slrCXS |
| Rocky Linux 8 | Yes | Standard installation |
| Rocky Linux 9 | Yes | Use slrCXS |
Troubleshooting
OpenSSL Errors on AlmaLinux 9
If CXS encounters an OpenSSL compatibility error on AlmaLinux 9 or another system using OpenSSL 3.x, run the alternative activation command:
slrCXS
CXS Is Not Scanning Files
Restart the cPanel service and then refresh the CXS license:
service cpanel restart
slrCXS
CXS Version Command Returns an Error
Check whether the CXS installation file exists in the expected cPanel directory:
ls -la /etc/cxs/cxs.pl
If the file is missing, reinstall CXS and then repeat the verification step.
Installation Complete
Once the CXS version command returns a version number and no installation errors remain, CXS is ready to scan files on your cPanel server.
