To ensure the security and stability of your hosting environment, it is critical to keep both the cPanel software and the underlying Operating System (OS) up to date.
Backup First:
Before performing manual updates, we strongly recommend creating a Snapshot or ensuring you have a recent backup. Updates can occasionally cause compatibility issues with custom configurations.
Before performing manual updates, we strongly recommend creating a Snapshot or ensuring you have a recent backup. Updates can occasionally cause compatibility issues with custom configurations.
1. Configuring Automatic Updates
cPanel runs a daily maintenance script (upcp) that handles updates automatically. You can configure what gets updated via WHM.
- Log in to WHM.
- Navigate to Server Configuration > Update Preferences.
- Release Tier: Select your preferred version (we recommend RELEASE or STABLE for production servers).
- Daily Updates: Ensure this is set to Automatic.
- Click Save at the bottom.
2. Force a Manual cPanel Update
If you need a specific bug fix immediately or if the automatic update failed, you can force an update.
Option A: Via WHM (Graphical)
- Log in to WHM.
- Navigate to cPanel > Upgrade to Latest Version.
- Click the button Click to Upgrade.
- Wait for the progress bar to complete.
Option B: Via SSH (Command Line)
This is the most reliable method as it provides detailed log output.
- Log in via SSH as
root. - Run the update script:
/usr/local/cpanel/scripts/upcp
3. Updating System Software (OS Packages)
Besides cPanel itself, you must update the system kernel and packages (managed via yum/dnf/apt).
Via WHM
- Navigate to Software > System Update.
- Click Proceed to scan for updates.
- If updates are found, confirm to install them.
Via SSH
Run the standard package manager update command:
# For AlmaLinux / Rocky Linux / CentOS
yum update -y
# For Ubuntu
apt update && apt upgrade -y
Reboot Required?
If the Kernel was updated during the system update, you must reboot your VPS for the changes to take effect.
(WHM will usually display a "Reboot Required" banner in the top right corner if this is the case).
If the Kernel was updated during the system update, you must reboot your VPS for the changes to take effect.
(WHM will usually display a "Reboot Required" banner in the top right corner if this is the case).