Page tree
Skip to end of metadata
Go to start of metadata


For cPanel & WHM version 11.50


The /var/cpanel/cpanel.config file stores all of the settings that WHM's Tweak Settings interface (Home >> Server Configuration >> Tweak Settings) contains, as well as certain configuration settings for other cPanel & WHM features.

Preconfigure the cpanel.config file


Some of the values that the /var/cpanel/cpanel.config file contains are dynamic values, or will only function with specific values. Before you create a /root/cpanel_profile/cpanel.config file, you must read the The cpanel.config File documentation.

To set these parameters, perform the following steps:

  1. As the root user, use a text editor to create the /root/cpanel_profile/cpanel.config file.
  2. With one entry per line, list the parameters and values that you wish to configure.

For example, to configure your server to deny the nobody user the ability to send email to a remote address, create the following cpanel.config file:


To configure your server to install MariaDB® instead of MySQL®, create the following cpanel.config file:



  • Parameters must follow the key=value format.
  • If you set MySQL® to version 5.1 ( mysql-version=5.1 ) when you install cPanel DNSONLY, the installation process automatically upgrades the MySQL installation to version 5.5. This is because cPanel & WHM version 11.46 discontinued support for MySQL 5.1, and cPanel DNSONLY does not include an easy way in which to upgrade your MySQL installation.