The cPanel & WHM Update Configuration File — /etc/cpupdate.conf

Introduction

The /etc/cpupdate.conf file on your server determines how cPanel & WHM will update the following:

• cPanel & WHM itself
• Packages installed by cPanel & WHM
• Packages installed by the operating system
• SpamAssassin rules

Editing /etc/cpupdate.conf

Each line of the /etc/cpupdate.conf file specifies how cPanel & WHM will update a certain aspect of the system.

You can edit this file 2 ways:

• Manually, using your preferred text editor via the command line
• By using the WHM Update Preferences feature — each setting on the screen changes a setting in the file

Using the command line to edit the file

To edit /etc/cpupdate, simply use a command line text editor (such as vi or nano).

You will need to understand the file's format:

• /etc/cpupdate.conf uses key=value pairs. Each pair must be on its own line.
• Spaces are not allowed either in the key or the value.
• A single "equals" sign (=) delimits the key from the value.
• Both the key and value are case-sensitive. Keys must be uppercase. Values must be lowercase.
  • Example: CPANEL=stable

Settings and their meanings

Configuration values

You may set each option below to one of the following values:

Update settings for cPanel-installed packages

The following settings correspond to the individual cPanel Package Updates on the WHM Update Preferences screen.

These settings define whether a cPanel-installed package will update when its update script is run.

Note: When the cPanel update script (/usr/local/cpanel/scripts/upcp) runs, it runs each package's update script. (See the table below for a list of update scripts.)

Update settings for other software