The /usr/local/cpanel/scripts/proxydomains script allows you to create proxy domain Domain Name System (DNS) records for a cPanel, WHM, or Webmail account from the command line.

This script adds the required subdomains to the main domain's DNS record, but does not create a VirtualHost entry in the httpd.conf file.

For more information, read our Tweak Settings - Domains documentation.

You cannot add the cpanel, whm, or webmail proxy subdomains for addon or parked domains. You can only add cpcontacts , cpcalendar , and webdisk proxy subomains to addon and parked domains.

Run the /scripts/proxydomains script

To run the /usr/local/cpanel/scripts/proxydomains script from the command line as the root user, use the following format:

/usr/local/cpanel/scripts/proxydomains [action] [options]

You can use either of the following actions:

addCreate a proxy subdomain.
removeRemove a proxy subdomain.


The following table lists the options that you can pass with this script:


The cPanel user's domains to configure.

If you do not specify a user, this script attempts to configure the proxy subdomains for all of the server's cPanel accounts.


The domain that you wish to configure.

If you do not specify a domain, this script attempts to configure the proxy subdomains for all of the server's cPanel accounts.


The proxy subdomain that you wish to configure.

If you do not specify a subdomain, the script adds or removes the following subdomains:

  • cpanel.example.com
  • whm.example.com
  • webmail.example.com
  • cpcalendars.example.com
  • cpcontacts.example.com
  • webdisk.example.com


Whether to enable replacement of existing records.

  • Always pass 0 as this option's value.
  • Only use this option to change Autodiscover hosts.


The Autodiscover host that you previously configured.



Whether the script should function as if Autodiscover support is not disabled, even if it is disabled.

  • Always pass 1 as the value for this option.
  • Use this option to remove the domain's Autodiscovery proxy subdomains after you disable their support.



Only perform the operation if proxy subdomains are enabled.


For example, to add the proxy subdomain webdisk.example.com for the cPanel user john, run the following command:

/usr/local/cpanel/scripts/proxydomains add --user=john --subdomain=webdisk --no_replace=0 --force_autodiscover_support=1 --ifenabled

The output resembles the following example:

Adding proxy subdomains for user john.

The options that you pass to the command determine its output.

Additional Records

The /usr/local/cpanel/scripts/proxydomains script adds additional entries to the DNS records if you configure the Thunderbird and Outlook autodiscover and autoconfig support (enables proxy subdomain and SRV record creation) setting to On in WHM's Tweak Settings interface (Home >> Server Configuration >> Tweak Settings). When you configure this setting to On , then this script also adds the following entires:

A records for: 

SRV and TXT records for:

SRV records for:

Additional documentation