Overview:

This interface allows you to configure many cPanel & WHM settings. Tabs at the top of the interface categorize the settings, and the All tab displays all of the settings.

Note:
  • These settings exist in the /var/cpanel/cpanel.config file. However, we recommend that system administrators use this interface to make changes.

  • Some settings may not appear if your server does not use the Standard Node server profile. For more information, read our How to Use Server Profiles documentation.

  • Click the question mark next to each setting’s description to learn more about the setting.

  • The interface displays a warning icon (yellow warning icon) next to any setting for which you have not specified a value. This includes settings that are new, settings that WHM has set to a default value, and settings that your server selected dynamically.

Compression

The Compression section includes the following settings:

Setting Description Values Default
gzip compression level This setting allows you to set the gzip compression level for pigz, which is a gzip-compatible program that uses multiple CPU cores simultaneously. Higher settings provide greater compression, but compress more slowly.
  • Minimum value: 1
  • Maximum value: 9
6
Number of pigz processes This setting allows you to set how many independent pigz processes the system uses to perform gzip compression. For the best performance, we recommend that you set this value to match the number of processor cores that are available on your server.
  • Minimum value: 1
  • Maximum value: 128
This setting defaults to the number of processor cores on your server.
Number of kilobyte chunks per compression work unit This setting allows you to control the size, in 1024-byte chunks, of compression work units that the system distributes to each pigz process.
  • Minimum value: 128
  • Maximum value: N/A
4096

cPAddons Site Software

The cPAddons Site Software section includes the following settings:

Setting Description Values Default
cPAddons Site Software admin email This setting specifies a contact email address that receives cPAddon moderation requests. The system also notifies resellers if they choose to configure their contact email address in the cPanel interface.
  • A moderation request is a request from a user who wishes to install or upgrade a cPAddon. You must approve the request before the user installs or upgrades a cPAddon.
  • We have deprecated the moderation feature and will remove it in the future. You cannot enable moderation for any cPAddons. Any cPAddons that currently use moderation will continue to function but, if you disable it, you cannot reactivate moderation.
To specify the cPAddon administrator’s email address, enter the email address that you wish to use in the text box. None
cPAddons Site Software source automatic updates This setting specifies whether you wish for cPanel & WHM to automatically update all of the cPAddons’ source files.
  • On — Enable
  • Off — Disable.
On
Max cPAddons Site Software installation requests This setting specifies the maximum number of moderation requests that a single user can make at one time. To specify a new value, enter the number of requests that you wish to allow in the text box.
  • Minimum value: N/A
  • Maximum value: N/A
99
Max cPAddons Site Software installation requests per addon This setting specifies the maximum number of moderation requests per cPAddon that a single user can make at one time. To specify a new value, enter the number of requests that you wish to allow per cPAddon in the text box.
  • Minimum value: N/A
  • Maximum value: N/A
99
cPAddons Site Software moderation notification This setting allows you to select whether the cPAddons administrator receives notifications about pending moderation requests.
  • On — Enable
  • Off — Disable.
Off
Allow cPAddons Site Software installations from non-cPanel sources This setting allows you to install third-party scripts on your server.
  • On — Enable
  • Off — Disable.
On
Allow cPAddons Site Software installations from modified sources This setting allows users to install previously-altered cPAddons. You may wish to enable this item when you test custom cPaddons.
  • On — Enable
  • Off — Disable.
Off
Notify reseller of cPAddons Site Software installations This setting notifies resellers whenever their users must update their cPAddons.
  • On — Enable
  • Off — Disable.
On
Notify root of cPAddons Site Software installations This setting notifies the cPAddons Site Software administrator whenever their users must update their cPAddons.
  • On — Enable
  • Off — Disable.
On
Notify cPanel users when they need to update their cPAddons Site Software installations This setting notifies cPanel users whenever they must update their cPAddons.
  • Allow users to choose (default) — This option allows cPanel users to specify whether they wish to receive notifications about out-of-date cPAddons.
  • always — This option allows cPanel & WHM to automatically notify users when their cPAddons are out-of-date.
  • never — This option allows you to specify that users should never receive notifications when their cPAddons are out-of-date.
Allow users to choose (default)

Development

The Development section includes the following setting:

Setting Description Values Default
Standardized Hooks - Debug Mode The Standardized Hooks system’s debug mode helps to troubleshoot hook issues. For more information, read our Guide to Standardized Hooks - Debug Mode documentation.
  • If, instead of this setting, you use the /var/cpanel/debughooks file to enable debug mode, your locale may revert to the English defaults for JavaScript elements. To fix this problem, run the echo -n > /var/cpanel/debughooks and /scripts/restartsrv_cpsrvd commands to disable debug mode and restart the cpsrvd daemon.
  • When you enable this setting, it will also enable debug mode in the cPanel interface. This will severely impact the loading and performance of the cPanel interface. We recommend that you disable this setting when you do not need it.
  • Debug mode is off. — The system does not display debug information or log it to the error log.
  • Debug mode is on. The system displays information about a hook while it executes, but does not log debug data to the error log.
  • Debug mode is on. The system displays information about a hook while it executes and logs debug data to the error log. — This setting outputs a large amount of data.
  • Debug mode is on. The system displays information about every stage for every hookable event, even if no hooks exist for that stage.
Debug mode is off.
User Interface - Debug Mode This setting changes the way the system generates user interfaces. For example, it disables optimizations such as minifications and cache-busting.
  • Debug mode is off. — The system does not display debug information or log it to the error log.
  • Debug mode is on. — The system displays information and logs it to the error log.
Debug mode is off.

Display

The Display section includes the following settings:

Setting Description Values Default
Default login theme This setting allows you to select the default login theme for cPanel users. Select a login theme. cpanel
Display File Usage information in the cPanel stats bar (inode count) This setting allows you to display the number of files and directories (inodes) that a cPanel account uses. The Statistics section of cPanel’s Home interface displays this information in the File Usage section.
  • On — Enable
  • Off — Disable.
Off
Number of accounts per page to display in “List Accounts”. This setting allows you to specify the number of accounts to display per page in WHM’s List Accounts interface (WHM >> Home >> Account Information >> List Accounts).
  • All — View all of the accounts on your server whenever you or a reseller views WHM’s List Accounts interface (WHM >> Home >> Account Information >> List Accounts).
  • 30 (default) — View 30 accounts per page. This is the default setting.
  • Select the text box and enter a value.
30 (default)

Domains

The Domains section includes the following settings:

Setting Description Values Default
Allow users to park subdomains of the server’s hostname This setting allows users to park subdomains on your server’s main domain. For example, for a user creating the subdomain.server.example.com alias on the server.example.com FQDN, On would cause the action to succeed.
  • On — Allow creation of subdomains.
  • Off — Don’t allow creation of subdomains. If a cPanel user tries to create a subdomain, they receive an error message.
Off
Allow cPanel users to create subdomains across accounts This setting allows a cPanel user to create an addon domain or subdomain on a domain that another user owns. For example, if a user owns the example.com domain, another user could create the store.example.com subdomain.
  • On — Allow creation of subdomains across accounts. Do not enable this option. It can cause serious security issues.
  • Off — Don’t allow creation of subdomains across accounts. If a cPanel user tries to create a subdomain on another account, they receive an error message.
Off
Allow WHM users to create subdomains across This setting allows WHM users to create an addon domain or subdomain for a domain that another user owns. For example, if a cPanel user owns the example.com domain, a WHM user could add a DNS zone for the store.example.com subdomain.
  • On — Allow creation of subdomains across accounts. Do not enable this option. It can cause serious security issues.
  • Off — Don’t allow creation of subdomains across accounts. This is the default setting.
Off
Allow Remote Domains This setting allows the creation of parked domains (aliases) and addon domains that resolve to other servers.
  • On — Allow creation. Do not enable this option. It can cause serious security issues.
  • Off — Don’t allow creation.
Off
Allow resellers to create accounts with subdomains of the server’s hostname. This setting allows resellers to create accounts with subdomains on your server’s main domain. For example, if your hostname is server.example.com, enable this setting to redirect user.server.example.com visitors to the reseller’s website.
  • On — Allow creation.
  • Off — Don’t allow creation.
Off
Allow unregistered domains This setting lets users add domains they didn’t register with a domain name registrar.
  • On — Allow creation.
  • Off — Don’t allow creation.
Off
Automatically add A entries for registered nameservers when creating a new zone This setting sets whether to create A entries automatically when a user creates a domain.
  • On — Create.
  • Off — Don’t create.
On
Replace service SSL certificates that do not match the local hostname This setting changes how the /usr/local/cpanel/scripts/checkallsslcerts script functions. If you enable this, the system replaces SSL certificates that don’t match the server’s hostname. The system replaces them with a cPanel-signed certificate. This also applies to wildcard certificates.
  • On — Replace the certificates.
  • Off — Retain the certificates.
On
Prevent cPanel users from creating specific domains This setting prevents creating domains whose names appear in the /var/cpanel/commondomains file. If you enable this, cPanel users can’t create any domains (addon or parked) that exist in the /var/cpanel/commondomains and /usr/local/cpanel/etc/commondomains files.
Don’t edit the /usr/local/cpanel/etc/commondomains file directly. If you do, the system will overwrite your changes whenever cPanel & WHM updates.
  • On — Prevent creation.
  • Off — Allow creation.
On
Check zone syntax This setting allows the system to check zone file syntax each time it saves or syncs DNS zone files.
  • On — Check the syntax.
  • Off — Don’t check the syntax.
On
Check zone owner This setting allows the system to check a DNS zone’s owner whenever it saves or syncs DNS zone files.
  • On — Check the owner.
  • Off — Don’t check the owner.
On
Enable DKIM on domains for newly created accounts DKIM (DomainKeys Identified Mail) verifies a message’s sender and integrity. It allows an email system to prove that a message is valid, not forged, and came from the specified domain. This setting allows you to specify whether to enable DKIM for new accounts by default.
The /scripts/enable_spf_dkim_globally script allows you to enable SPF and DKIM for accounts that exist on the server, and to create the appropriate DNS records for their domains. For more information, read our The SPF and DKIM Global Settings Script documentation.
  • On — Enable DKIM.
  • Off — Don’t enable DKIM.
On
Enable SPF on domains for newly created accounts SPF (Sender Policy Framework) keeps spammers from sending email that shows your domain as the sender (spoofing). This adds addresses to a list of computers that you authorize to send mail from your domain. It verifies that your domain’s sent messages come from the listed sender. This reduces the amount of backscatter that you receive. This setting allows you to specify whether to enable SPF for new accounts by default.
The /scripts/enable_spf_dkim_globally script allows you to enable SPF and DKIM for accounts that exist on the server, and to create the appropriate DNS records for their domains. For more information, read our The SPF and DKIM Global Settings Script documentation.
  • On — Enable SPF.
  • Off — Don’t enable SPF.
On
DNS request management application This setting determines what handles DNS management requests.
  • dnsadmin, auto-detect SSL — Use dnsadmin.
  • Select the text box and enter the path to another application.
dnsadmin, auto-detect SSL
Service subdomains This setting gives users access to cPanel & WHM through standard HTTP ports (80 and 443).
  • When you enable this, the system creates an entry in the httpd.conf file.
  • Do not manually disable the mod_rewritemod_headers, or mod_proxy settings in the httpd.conf file.
If you enable this, the system creates these service subdomains, where example.com is the domain: