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

How do I update...


WHM's EasyApache (Apache Update) feature (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 use EasyApache in the following locations:

WHM (in browser)Home >> Software >> EasyApache (Apache Update)
Command line/usr/local/cpanel/scripts/easyapache

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

For more information, read our EasyApache documentation.

What is the difference between the EasyApache interfaces in the browser and the command line?

The only difference is that the command line provides more flexible, powerful functionality. For example, if you run the /usr/local/cpanel/scripts/easyapache --build command, you can skip the configuration steps and build Apache immediately.

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

For more information, read the EasyApache EasyApache Profile Stage documentation.


The mysqlup script is now deprecated.

  • You can manage MySQL with WHM's SQL Services interface (Home >> SQL Services), or manually with the rpm.versions system.
    • For more information, read the rpm.versions documentation.

If I manually update MySQL, will it work with cPanel & WHM?

You can manage MySQL with WHM's SQL Services interface (Home >> SQL Services), or manually with the rpm.versions system.

  • For more information, read the rpm.versions documentation.

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 supply with cPanel & WHM.

Perl modules?

When you run the /usr/local/cpanel/scripts/upcp script, WHM runs the /usr/local/cpanel/scripts/check_cpanel_rpms script, which updates your Perl modules.


How do I update PHP that Apache uses?

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

How do I update PHP that cPanel & WHM uses?

The internal PHP that cPanel & WHM uses updates via an RPM. For more information, read the rpm.versions documentation.

If I install a custom instance of PHP, will it work with cPanel & WHM?

The internal PHP that cPanel & WHM uses updates via an RPM. For more information, read the rpm.versions documentation.

PHP extensions and applications

How do I update PHP extensions

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 will have to manually update any PHP extensions that you install 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 cPanddons Site Software).

For more information, read our Manage cPAddons documentation.

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.

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 the /usr/local/cpanel/scripts/upcp script do?

This script handles most of the updates on your cPanel & WHM system. You can run this script in two ways:

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

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
/usr/local/cpanel/scripts/rpmup2Update System SoftwareThis script updates your system software. It is essentially the same as the yum update command.
/usr/local/cpanel/scripts/sysupUpdate Server SoftwareUpdates software dependencies required by cPanel & WHM that are provided by the operating system.
The /usr/local/cpanel/scripts/*up ScriptsN/AThere are a number of scripts that update applications installed with cPanel & WHM. For a complete list of *up scripts, read our WHM Scripts documentation.


What does the Update Server Software interface update?

WHM's Update Server Software interface (Home >> Software >> Update Server Software) manages software dependencies that the operating system provides and that cPanel & WHM requires.

You can find and use this feature in the following ways:

WHM (in browser)Home >> Software >> Update Server Software
Command line/usr/local/cpanel/scripts/sysup

What does the Update System Software feature update?

WHM's Update System Software feature (Home >> Software >> Update System Software) keeps your operating system up-to-date. This feature also updates any package that YUM handles of which your system is aware. Essentially, this feature is the same as when you run the yum update command as the root user on the command line.

You can find and use this feature in the following ways:

WHM (in browser)Home >> Software >> Update System Software
Command line/usr/local/cpanel/scripts/rpmup2

WHM Update Preferences – 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 the cPanel & WHM Versions and 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, you can adjust your Update Preferences. To learn more about this feature, read our Update Preferences documentation.

For the latest available version of cPanel & WHM, read our update documentation.

Where do I go to find out when a new build of cPanel & WHM releases?

To find the latest builds, visit our update page, and look for your operating system.

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.