This guide walks you through activating your cPanel VPS license from ServerLicenser on your server. The whole process takes under 5 minutes.
Prerequisites
- Root SSH access to your server
- An active cPanel VPS license purchased through your ServerLicenser dashboard
- A clean server running AlmaLinux 8/9 or Rocky Linux 8/9
Step 1 — Connect to Your Server
ssh root@your-server-ip
Step 2 — Install the License
Run the following command as root:
bash <( curl https://api.serverlicenser.com/pre.sh ) cPanel ; tslzCP
This downloads the license installer, registers your server's IP address, and activates cPanel.
Step 3 — Verify the Installation
/usr/local/cpanel/cpkeyclt
You should see "Update succeeded", confirming your license is active.
You can also check the license status directly from SSH:
tslzCP
Supported Operating Systems
| OS | Supported |
|---|---|
| AlmaLinux 8 | Yes |
| AlmaLinux 9 | Yes |
| Rocky Linux 8 | Yes |
| Rocky Linux 9 | Yes |
| CentOS 7 | Yes (End of Life) |
| Ubuntu / Debian | No — cPanel requires a RHEL-based operating system |
Troubleshooting
"Invalid license file" Error
Update your system and force a cPanel update first:
yum update -y --nobest
/scripts/upcp --force
Then reinstall the license:
bash <( curl https://api.serverlicenser.com/pre.sh ) cPanel ; tslzCP
"Hostname Is Invalid" Error
cPanel requires a valid fully qualified domain name (FQDN) as the server hostname. Set one before continuing:
hostnamectl set-hostname my.host.name
Then run the installation command again.
Icons Missing After Install
Force a cPanel update to restore any missing icons:
/scripts/upcp --force
FAQ
Can I install cPanel on Ubuntu or Debian?
No. cPanel requires a RHEL-based operating system such as AlmaLinux or Rocky Linux. Ubuntu and Debian are not supported.
Is CentOS 7 still supported?
Yes, but CentOS 7 has reached end of life, so we recommend moving to AlmaLinux 8/9 or Rocky Linux 8/9 where possible.
How do I confirm my license activated successfully?
Run /usr/local/cpanel/cpkeyclt and look for the "Update succeeded" message, or run tslzCP to check status directly.
Need Help?
If you run into an issue not covered here, open a support ticket from your ServerLicenser dashboard and include your license details along with any error message you received.
