You can find our user documentation at

Check out our new API beta site!

Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.46

How do I update...

How do I update cPanel & WHM?

The /usr/local/cpanel/scripts/upcp script updates most of the cPanel & WHM services on your cPanel & WHM system. You can run this script in two ways:

  • Use WHM's Upgrade to Latest Version interface (Home >> cPanel >> Upgrade to Latest Version).
  • On the command line, run the /usr/local/cpanel/scripts/upcp script as the root user.

This script also calls a number of other scripts within the /usr/local/cpanel/scripts/ directory to update most of the software on your system. The /usr/local/cpanel/scripts/upcp script also runs the following scripts:


Script nameWHM featureDescription
The /usr/local/cpanel/scripts/rpmup2 script.
Update System Software (Home >> Software >> Update System Software)This script updates your system software. It is essentially the same as the yum update command.
The /usr/local/cpanel/scripts/sysup scriptUpdate Server Software (Home >> Software >> Update Server Software)
This script updates software dependencies that cPanel & WHM requires and that the operating system provides.
The /usr/local/cpanel/scripts/*up scriptsN/AFor a complete list of *up scripts, read our WHM Scripts documentation.

How do I update Apache?

WHM's EasyApache (Apache Update) interface (Home >> Software >> EasyApache (Apache Update) updates Apache as well as other applications and libraries. 


Apache will not update automatically when you run the /usr/local/cpanel/scripts/upcp script.


You can find and run EasyApache in the following locations:

WHMHome >> Software >> EasyApache (Apache Update)
Command line/usr/local/cpanel/scripts/easyapache

When you run EasyApache, the system prompts you to select the version of Apache that you wish to use. If you choose a new version number, EasyApache will update Apache accordingly.

For a full list of command line arguments, run the /usr/local/cpanel/scripts/easyapache --help command.

For more information, read the following documents:

How do I update MySQL? 

The mysqlup script is deprecated. You can manage MySQL® with WHM's SQL Services interface (Home >> SQL Services), or manually with the /usr/local/cpanel/scripts/check_cpanel_rpms script

You may experience compatibility problems with any software that you choose to install manually. For that reason, we only support the MySQL distributions that we ship with cPanel & WHM.

How do I update Perl modules?

If you wish to update your Perl modules, perform either of the following actions:


How do I update the PHP version that Apache and cPanel & WHM use?

To change the PHP version that Apache uses, use the EasyApache (Apache Update) interface (Home >> Software >> EasyApache (Apache Update)).

To update the version of PHP that cPael & WHM uses, perform either of the following actions:

  • Run the /scipts/phpup script via the command line.
  • Use WHM's Configure PHP and suEXEC interface (Home >> Service Configuration >> Configure PHP and SuExec).

For more information, read our rpm.versions documentation.

PHP extensions and applications

How do I update PHP extensions and applications?

You can run EasyApache to update the PHP extensions that WHM provides.

  • You can run EasyApache in WHM's EasyApache (Apache Update) interface (Home >> Software >> EasyApache (ApacheUpdate)).
  • You can also run EasyApache with the /usr/local/cpanel/scripts/easyapache script via the command line.


You must manually update any PHP extensions that you installed manually.

How do I update PHP applications?

WHM will update any applications that it provides (such as phpMyAdmin) when the /usr/local/cpanel/scripts/upcp script runs.

You can also update any cPaddons that you installed with WHM's Manage cPAddons Site Software interface (Home >> cPanel >> Manage cPaddons Site Software).

How do I update RPMs?

RPMs and other modules that install with cPanel & WHM automatically update when the /usr/local/cpanel/scripts/upcp script runs.

If you install RPMs that cPanel & WHM's default installation does not include, you will need to update these RPMs manually. These RPMs and packages will only receive an update if you add them to the YUM repository.


Third-party repositories can cause problems with cPanel & WHM, as well as problems with updates from the OS repository. Learn about the risks before you use a third-party repository.

For more information, read our How to Override the rpm.versions System documentation.

How do I update Ruby Gems?

You will have to manually update any RubyGems that you have installed.

When you run the /usr/local/cpanel/scripts/installruby script, WHM will install only required modules. It will update these modules when the /usr/local/cpanel/scripts/upcp script runs.

How do I update cPAddons?

You can manage specific configuration options for your cPAddons with WHM's Manage cPAddons Site Software interface (Home >> cPanel >> Manage cPAddons Site Software). This interface allows you to choose which cPAddons that you wish to update automatically.

These cPAddons update by a cronjob that runs nightly. This cronjob updates the cPAddon repository for the entire server.

What does "Automatic" mean in WHM's Update Preferences interface?

Automatic updates occur daily. For more information about Update Preferences, see our Update Preferences documentation.

What does the yum update command do?

Yum (Yellowdog Updater, Modified) is an open-source command line package management utility for Linux. When you run the yum update command from the command line and you do not specify a package, the command updates all of the packages that your system's repository contains. Yum also makes sure that all dependencies are satisfied.

What are release tiers? Which one is right for me?

For an explanation of our release tiers, read our Product Versions and the Release Process documentation..

How do I make sure that my server has the latest version of cPanel & WHM?

WHM displays the version in the upper right-hand corner of the interface.

You can also run /usr/local/cpanel/cpanel -V on the command line to verify the version.

To define how you wish to update your server's software, adjust your settings in the Update Preferences interface (Home >> Server Configuration >> Update Preferences).

For the latest available version of cPanel & WHM, visit our httpupdate page.

What do I do if cPanel & WHM will not update?

If cPanel & WHM will not update, check for an error message in the WHM interface. If you cannot solve the issue, submit a ticket to our support department.

What if my system returns an error that the EXIMUP key is set to never?

If you set the EXIMUP key's value to inherit in the /etc/cpupdate.conf file, you may receive an error that informs you that the EXIMUP key's value is set to never. To resolve this issue, perform the following steps:

  1. Set the CPANEL key's value to 11.36 in the /etc/cpupdate.conf file.

  2. Run the cPanel & WHM update process.
  3. Set the CPANEL key's value to the desired tier (for example, RELEASE) in the /etc/cpupdate.conf file.
  4. Run the cPanel & WHM update process again.