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.40

How do I update...


The EasyApache (Apache Update) feature 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 you wish to use. If you choose a new version number, EasyApache will update Apache accordingly. It is important to check back frequently as new Apache builds become available.

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 /usr/local/cpanel/scripts/easyapache --build you can skip the configuration steps and build Apache immediately.

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

For more information, read the EasyApache documentation.



  • mysqlup is now deprecated.
  • You can manage MySQL with the interface or manually with the rpm.versions system.


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

Yes. You can manage MySQL with the interface or manually with the rpm.versions system.

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

There may be compatibility problems with any software you choose to install manually. For that reason, we only support MySQL versions that we supply with cPanel & WHM.


Perl modules?

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



How do I update PHP used by Apache

To update the PHP instance used by Apache, run /usr/local/cpanel/scripts/phpup from the command line.

To change the PHP version used by Apache, access EasyApache, either at Home >> Software >> EasyApache (Apache Update) in WHM, or fun /usr/local/cpanel/scripts/easyapache on the command line.


How do I update PHP used by cPanel

PHP is updated by an RPM. For more information, read the rpm.versions documentation.


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

PHP is updated by an RPM. For more information, read the rpm.versions documentation.


PHP extensions and applications?


How do I update PHP extensions

You can EasyApache to update the PHP extensions provided by WHM (/usr/local/cpanel/scripts/easyapache).

You will have to manually update PHP extensions that you have installed manually.


How do I update PHP applications?

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

You can use the WHM Manage cPAddons interface to update cPAddons that you have installed.



RPMs and other modules that are installed with cPanel are automatically updated when the /usr/local/cpanel/scripts/upcp script runs.

If you have installed RPMs that are not included with cPanel & WHM's default installation, you will need to update these RPM's manually. These RPMs and packages will only receive an update if you have added them to the YUM repository.


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


Ruby Gems?

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

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



You can manage specific configuration options for your cPAddons with the Manage cPAddons  feature located at Home >> cPanel >> Manage cPAddons in your WHM interface. This feature will allow you to choose which cPAddons you wish to update automatically.

These cPAddons are updated 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 /usr/local/cpanel/scripts/upcp as the root user.
  • In WHM, use the Upgrade to Latest Version feature at 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 System Software Updates 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 feature update?

The Update Server Software feature manages software dependencies provided by the operating system 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?

The Update System Software feature keeps your operating system up-to-date. This feature will also update any package that is handled by YUM of which your system is aware. Essentially, this feature is the same as when you run yum update 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 on the WHM Update Preferences screen?

Automatic updates occur every night at midnight. 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 yum update from the command line and you do not specify a package, all of the packages contained within your system's repository are updated. YUM will also make 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 cPanel & WHM 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, you can adjust your Update Preferences. To learn more about this feature, read our Update Preferences documentation.

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


Where do I go to find out when a new build of cPanel is released?

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, 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.