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
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 ; slrCP
Step 3 — Verify the Installation
/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:
yum update -y --nobest
/scripts/upcp --force
Then reinstall the license:
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:
hostnamectl set-hostname my.host.name
Then run the installation command again.
GPG Keys Error During cPanel Install
Import the AlmaLinux GPG key:
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.
