The rpm.versions system manages many of the RPMs on your cPanel & WHM server. The packages that the rpm.versions system manages may include the following types of RPMs:
The rpm.versions system does not manage the packages for your operating system's distribution.
RPM stands for RPM Package Manager. In our documentation, the term "RPM" may refer to any of the following items:
.rpmfile (for example,
For more information about RPMs, visit the RPM website.
Source RPMs (SRPMs) contain the source code for each RPM on your system. Unlike RPMs, SRPMs are not compiled.
For information on how the rpm.versions system stores SRPM information, read our The rpm.versions File documentation.
The rpm.versions system manages RPMs based on the settings that it finds in several YAML files on your server. These files use the following priority:
/var/cpanel/rpm.versions.d/local.versionsfile contains settings that system administrators set locally. These settings override all other rpm.versions system settings on the server.
.versionsfiles in the
/var/cpanel/rpm.versions.d/directory, which override the cPanel-provided defaults.
/usr/local/cpanel/etc/rpm.versions file contains cPanel-provided settings, based on your server's version of cPanel & WHM. All local
.versions files override these settings.
We do not recommend that you modify the
For a more detailed explanation of how to work with these files, read our The rpm.versions File, RPM Targets, and How to Override the rpm.versions System documentation.
The rpm.versions system includes the following scripts:
/scripts/check_cpanel_rpmsscript tracks missing or out-of-date RPMs, checks for altered RPMs, and uninstalls unnecessary RPMs. If you experience problems with an RPM on your server, this script can help you find and fix the issue. For more information, read our The check_cpanel_rpms Script documentation.
/scripts/update_local_rpm_versionsscript allows system administrators to safely edit the
/var/cpanel/rpm.versions.d/local.versionsfile's contents, in order to override settings in the rpm.versions system. For more information, read our The update_local_rpm_versions Script documentation.
In addition to the ability to override settings on a server, you can create and install your own custom RPMs, and modify the RPM installation process. If you wish to modify and replace cPanel-provided RPMs, read our How to Build and Install Custom RPMs documentation.