The sysinfo.config File

Last modified: December 22, 2021


We removed this configuration file in cPanel & WHM version 100. For more information, read our cPanel Deprecation Plan documentation.


The /var/cpanel/sysinfo.config file stores the server’s system information settings. cPanel & WHM uses this file to determine which packages to download during installation and upgrades.

If the detection system fails to correctly identify the distribution or version of Linux, you can manually override those settings.


This feature is for advanced users only. Changes that you make to the default configuration may render your server nonfunctional. Exercise caution when you edit this file.

Initial settings

cPanel & WHM runs the /usr/local/cpanel/scripts/gensysinfo script as part of nightly maintenance to automatically generate the sysinfo.config file. The system will not update the file if it is less than a day old.

If the sysinfo.config file does not exist or becomes corrupt, log in to the server via SSH as the root user and run the /usr/local/cpanel/scripts/gensysinfo script to generate a new file.

Keys and default settings

The following table lists the keys that the system stores in the /var/cpanel/sysinfo.config file:

Key Description Possible values Example
ises Whether the OS distribution is an Enterprise system. This is a legacy parameter as of cPanel & WHM version 11.38.
  • 0 — Default value.
  • 1 — The server distribution contains Corporate, Advanced Server, or Enterprise in its name.
  • 2 — The server distribution is CloudLinux™, AlmaLinux OS, or CentOS.
lock A list of package and sysinfo.config file keys that you do not want the system to update. A comma-separated list of package or sysinfo.config file key names:
  • release
  • rpm_arch
  • rpm_dist
  • rpm_dist_ver
release The Linux distribution’s release number. A valid string. 6.6
rpm_arch The OS’s architecture. x86_64 — A 64-bit system. x86_64
rpm_dist The name of the system’s OS distribution.
  • amazon
  • centos
  • rhel
  • cloudlinux
  • almalinux
rpm_dist_ver The system’s OS distribution’s version number.
  • 6
  • 7
  • 8
  • unknown — If the rpm_dist_ver key uses this value, run the /usr/local/cpanel/scripts/gensysinfo script.
The rpm_dist_ver value must match the system’s initial version of the operating system’s distribution.

Additional Documentation