Overview

The AutoConfigure (AutoConfig) and Autodiscover services quickly and easily configure a user's mail client to receive their cPanel email. These services work with Microsoft Outlook®, Outlook Express®, Thunderbird, and most other popular mail clients.

Enable AutoConfig and Autodiscover

To enable AutoConfig and Autodiscover, perform the following steps:

  • In cPanel & WHM version 76, we renamed the following settings:
    • The Proxy subdomains setting to Service subdomains.
    • The Thunderbird and Outlook autodiscover and autoconfig support (enables proxy subdomain and SRV record creation) setting to Thunderbird and Outlook autodiscover and autoconfig support (enables service subdomain and SRV record creation).
  • For more information, read our Service and Proxy Subdomains documentation.
  1. Navigate to the Domains section of WHM's Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings).
  2. Locate the Service subdomains setting and select On.

  3. Locate the Thunderbird and Outlook autodiscover and autoconfig support (enables service subdomain and SRV record creation) setting and select On.

  4. Click Save.

Additional settings

You can find the following additional AutoConfig and Autodiscover settings in the Domains section of WHM's Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings):

Preferred mail service to configure to use for Thunderbird and Outlook® autodiscover and autoconfig support

This setting allows you to choose the email transfer method to use with Thunderbird and Outlook with Autodiscover and AutoConfig support.

This setting defaults to imap.

  • We recommend that you select IMAP and not POP3.
  • You must enable the Thunderbird and Outlook autodiscover and autoconfig support (enables service subdomain and SRV record creation) option in order to configure this setting.

Host to publish in the SRV records for Outlook autodiscover support.

Microsoft Outlook’s Autodiscover service searches DNS for an SRV record for an email inbox’s domain that points to a particular server for Autodiscover. By default, this server is cpanelemaildiscovery.cpanel.net.

This setting allows system administrators to perform the following actions:

This setting defaults to cpanelemaildiscovery.cpanel.net.

  • For more information about how to use a custom XML file, visit Mozilla's autoconfiguration page, or the Exchange's Autodiscover page.
  • You must enable the Thunderbird and Outlook autodiscover and autoconfig support (enables service subdomain and SRV record creation) option in order to configure this setting.


For more information about Microsoft Outlook's Autodiscover feature, visit Microsoft's Support website.


We recommend that you use signed certificates that a Certificate Authority (CA) signed, rather than self-signed certificates, which may cause security issues. If you use a self-signed certificate, the browser may generate a warning message.


Use AutoConfig and Autodiscover

To use AutoConfig and Autodiscover, enter a cPanel email address and password in your mail client. The services will automatically configure your mail client.

Apple email clients

Apple® email clients do not support AutoConfig or AutoDiscover for IMAP servers. To use AutoConfig and AutoDiscover with Apple products, your server must run Exchange rather than IMAP.

When you configure an Apple email client to access your cPanel email address, we strongly recommend that you follow the directions in our Email Accounts documentation.

Additional documentation