Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Include Page
LIB:_Version68
LIB:_Version68

Table of Contents
stylenone

Overview

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 DNS records for the subdomains to the main domain's records, but does  not create a VirtualHost entry in the /usr/local/apache/conf/httpd.conf file.

Warning
titleImportant:

This script only adds or removes the DNS entries for proxy subdomains.

  • By default, WHM automatically creates proxy subdomains for new users. To prevent this, you must disable the Proxy subdomain creation setting in the Domains section of WHM's Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings).
  • To disable proxy subdomains that already exist, you must override the current proxy subdomain. For example, redirect the cpanel.example.com subdomain to the example.com domain.


Note
titleNote:

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

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:

Code Block
languagebash
/usr/local/cpanel/scripts/proxydomains [action] [options]

Actions

You can use either of the following actions:

ActionDescription
addCreate a proxy subdomain.
remove

Remove a proxy subdomain.

Options

Note
titleNotes:
  • If you do not specify a user, this script attempts to configure the DNS records for every proxy subdomain on every cPanel account on the server.
  • If you specify a user but you do not specify a domain, this script attempts to configure the DNS records for every proxy subdomain on the user's account.

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

Option
Description
Example
--user

The account for which to configure the user's domains.

john
--domain

The domains to configure.

example.com
--subdomain

The proxy subdomain that you wish to configure.

Note
titleNote:

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

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


webdisk
--no_replace

Whether to enable the replacement of existing records.

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


0
--old_autodiscover_host

The Autodiscover host that you previously configured.

autodiscover.example.com
--force_autodiscover_support
Whether the script should function as though you enabled Autodiscover support, even if you disabled it.

 

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


1

--ifenabled

Only perform the operation if proxy subdomains are enabled.

(none)

Example

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

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

The output resembles the following example:

Code Block
languagebash
Adding proxy subdomains for user john.


Note
titleNote:

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 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:

Record typeEntry
A records
  • autoconfig 
  • autodiscover
SRV and TXT records
  • _caldav._tcp
  • _caldavs._tcp
  • _carddav._tcp
  • _carddavs._tcp
SRV records

_autodiscover._tcp

Additional documentation

Localtab Group


Localtab
activetrue
titleSuggested documentation

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("domains","dav","dns") and label = "whm" and space = currentSpace()


Localtab
titleFor cPanel users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("domains","dav","dns") and label = "cpanel" and space = "ALD"


Localtab
titleFor WHM users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("domains","dav","dns") and label = "whm" and space in (currentSpace(),"CKB")


Localtab
titleFor developers

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("domains","dav","dns") and space = "DD"