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

Terminal
ssh root@your-server-ip

Step 2 — Install the License

Run the following command as root:

Terminal
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

Terminal
/usr/local/cpanel/cpkeyclt

You should see "Update succeeded", confirming your license is active.

You can also check the license status directly from SSH:

Terminal
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:

Terminal
yum update -y --nobest
/scripts/upcp --force

Then reinstall the license:

Terminal
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:

Terminal
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:

Terminal
/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.

Was this answer helpful? 0 Users Found This Useful (0 Votes)