/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 DNS records for the subdomains to the main domain's records, but does not create a VirtualHost entry in the
This script only adds or removes the DNS entries for proxy subdomains.
You cannot add the
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:
|Create a proxy subdomain.|
Remove a proxy subdomain.
The following table lists the options that you can pass with this script:
The account for which to configure the user's domains.
The domains to configure.
The proxy subdomain that you wish to configure.
The Autodiscover host that you previously configured.
Whether the script should function as though you enabled Autodiscover support, even if you disabled it.
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.
/usr/local/cpanel/scripts/proxydomains script adds additional entries to the DNS records if you enable the Thunderbird and Outlook autodiscover and autoconfig support (enables proxy subdomain and SRV record creation) setting to in the Domains section of WHM's Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings). When you enable this setting , this script also adds the following entries: