Step 1: Check Your cPanel Tier
cPanel updates follow different tiers (LTS, Stable, Release, Current, Edge). To check your current tier, run:
cat /etc/cpanel/tier
If it’s set to LTS and you want the latest version, you may need to change it to Release or Current.
Step 2: Set the Correct Release Tier
If necessary, change your update tier to Release (recommended) by running:
echo "release" > /etc/cpanel/tier
For the latest stable version, you can use:
echo "stable" > /etc/cpanel/tier
Step 3: Update cPanel to the Latest Version
Run the following command to upgrade cPanel:
/scripts/upcp --force
This will update your cPanel to the latest version available for your selected tier.
Step 4: Verify the Upgrade
After the upgrade, check the cPanel version with:
cat /usr/local/cpanel/version
You should see the latest version if the upgrade was successful.
Step 5: Restart cPanel Services
Once updated, restart cPanel and associated services:
systemctl restart cpanel
or
service cpanel restart
Step 6: Check for Errors
Run this command to check for potential issues:
/usr/local/cpanel/scripts/check_cpanel_rpms --fix
This will resolve any missing or broken dependencies.
Step 7: Verify cPanel/WHM Access
- Log in to WHM (https://your-server-ip:2087)
- Go to “Server Information” or “cPanel Version” to confirm the upgrade.
Additional Tips:
- Ensure your license is active before upgrading (/usr/local/cpanel/cpkeyclt).
- Make a full server backup before upgrading (recommended).
- Check cPanel’s official changelog for new features and known issues in the latest version.