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

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.48


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

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 your preferred 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 will automatically upgrade the MySQL installation to version 5.5. This is because cPanel & WHM version 11.46 will discontinue support for MySQL 5.1, and cPanel DNSONLY does not include an easy way in which to upgrade your MySQL installation.