The cPanel Update Configuration File - cpupdate.conf


Last modified: December 6, 2019

Overview

The /etc/cpupdate.conf file on your server determines how cPanel & WHM updates the following system components:

  • cPanel & WHM itself.
  • Installed RPMs (RPM Package Manager files).
  • Apache SpamAssassin™ rules.

How to edit the configuration file

Each line of the /etc/cpupdate.conf file determines how cPanel & WHM updates the specified system component. You can edit this file with your preferred text editor.

File format

The /etc/cpupdate.conf file appears similar to the following example:

1
2
3
4
5
CPANEL=release
RPMUP=daily
SARULESUP=daily
STAGING_DIR=/data
UPDATES=daily
Notes:
  • Each KEY=value pair is on a separate line.
  • A single equals sign (=) separates the uppercase KEY and lowercase value.
  • The file must not contain spaces.

Configuration values

The following keys and values determine how to update specified components of the system:

CPANEL

This determines the server’s release tier or product version. In WHM’s Update Preferences interface (WHM >> Home >> Server Configuration >> Update Preferences), this is the Release Tier setting.

You can specify either of the following value types:

  • A release tier name (edge, current, release, stable, or lts), to ensure that your server always uses the appropriate version for that tier.
  • A cPanel & WHM version number, to specify an exact version (for example, 58, 11.58, or 58.123.45)

For example:

CPANEL=release
RPMUP

This determines how to update the operating system’s RPMs. The /usr/local/cpanel/scripts/rpmup script uses this value.

You can specify one of the following values:

  • daily — Update RPMs daily.
  • manual — Update RPMs manually (for example, via the command line).
  • never — Prevent both automatic and manual updates to RPMs.

For example:

RPMUP=daily
SARULESUP

This determines how to update Apache SpamAssassin™ rules. The /usr/local/cpanel/scripts/sa-update_wrapper script uses this value.

You can specify one of the following values:

  • daily — Update rules daily.
  • manual — Update rules manually (for example, via the command line).
  • never — Prevent both automatic and manual updates to rules.

For example:

SARULESUP=daily
STAGING_DIR

This setting determines the location of the staging directory.

In WHM’s Update Preferences interface (WHM >> Home >> Server Configuration >> Update Preferences), this is the Staging Directory setting.

You can specify any valid path.

For example:

STAGING_DIR=/data
UPDATES

This setting determines how to update cPanel & WHM when updates become available. The /usr/local/cpanel/scripts/upcp script uses this value.

You can specify one of the following values:

  • daily — Update cPanel & WHM daily.
  • manual — Update cPanel & WHM manually (for example, via the command line).
  • never — Prevent both automatic and manual updates to cPanel & WHM.

For example:

UPDATES=daily

Additional Documentation