This guide walks you through activating your cPanel Dedicated license from ServerLicenser on a bare-metal or high-resource dedicated server.

Prerequisites

  • Root SSH access to your dedicated server
  • An active cPanel Dedicated license purchased through your ServerLicenser dashboard
  • 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 ; slrCP

Step 3 — Verify the Installation

Terminal
/usr/local/cpanel/cpkeyclt

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


VPS vs Dedicated — Which Do I Need?

Type Use When
VPS Your server is a virtual machine (VPS, cloud instance)
Dedicated Your server is a physical bare-metal machine

If you're not sure which applies to you, check with your hosting provider whether your server is virtual or physical.


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 ; slrCP

"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.

GPG Keys Error During cPanel Install

Import the AlmaLinux GPG key:

Terminal
rpm --import https://repo.almalinux.org/almalinux/RPM-GPG-KEY-AlmaLinux

FAQ

Do I need a VPS or Dedicated license?
Use a VPS license if your server is a virtual machine or cloud instance. Use a Dedicated license if your server is a physical, bare-metal machine. Check with your hosting provider if you're unsure which type you have.

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.


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)