Set Up Mail Client

This element (ia-generated) isn't supported, or may require an update to be displayed. You can try to refresh the app.

Overview

The Set Up Mail Client interface helps you configure a mail client to access an email address. A mail client lets you access your email account from an app on your computer or mobile device instead of by visiting a URL address (for example, the Apple® Mail client).
To access the Set Up Mail Client interface, perform the following steps:
    .1Navigate to cPanel’s  Email Accounts  interface (cPanel » Home » Email » Email Accounts).
    .2Locate the email account you want to set up in your external mail client. Click Connect Devices next to this account. The Set Up Mail Client interface will appear.

Requirements and support

You must have an external mail client installed on your computer or mobile device to use this feature.

Exchange ActiveSync

To use Exchange ActiveSync to set up calendars, contacts, and email on an Android device all at once, read our  How to Sync Calendars, Contacts, and Email on Android Devices  documentation.

LDAP authentication

We do not support LDAP authentication for mail applications. You can use OpenID Connect to connect an external authentication server to your mail application if you want to use LDAP. You will need to contact your hosting provider to setup OpenID Connect if you do not have WHM access. For more information on OpenID Connect, read our  OpenID Connect  documentation.

Mail Client Automatic Configuration Scripts

cPanel offers automatic configuration scripts for common mail clients, including:
  • Windows Live Mail®
  • iOS® for iPhone®, iPad®, and iPod®
  • macOS®  Mail.app ®.
If we list your mail client in the Mail Client Automatic Configuration Scripts section of the  Set Up Mail Client  interface, you can configure the mail client to receive emails with the following steps:
    .1Navigate to cPanel’s  Email Accounts  interface (cPanel » Home » Email » Email Accounts).
    .2Click Connect Devices next to the account whose emails you want the mail client to receive. The Set Up Mail Client interface will appear.
    .3Locate your mail client in the Application section.
NoteIf you do not see your mail client, you must  manually configure  it.
    .4Select your mail client application’s script from the Protocols list next to your mail client. For example, to set up a Windows Live Mail® client with IMAP over SSL/TLS, click IMAP over SSL/TLS in the Windows Live Mail® row. A new window will appear with instructions.
ImportantWe strongly recommend that you use the Secure SSL/TLS setting. This setting provides increased security.
    .5Review the system’s instructions, then click Proceed to continue. The system will then attempt to download the script.
ImportantClicking Proceed will prompt an automatic download of the appropriate configuration script. If you have disabled automatic downloads in your browser, you must enable them to proceed.
    .6Run the automatic configuration script. You may do so in two ways:
  • If your browser prompts you to open, run, or save the script, select Run or Open to continue.
  • If your browser does not prompt you to open, run, or save the script, find the script in your computer’s Downloads folder and run it.
    .7The system may ask if you are sure you want to install the script. Select Continue or Yes to continue the installation.
    .8The system may prompt you for the email account’s password. Enter the password and click Install.
Note Enter the password for the email account, not your computer.
9. When you complete the process, your mail client will open and log in to your email account.

Mail Client manual settings

If your mail client does not appear in the list of clients with automatic configuration scripts, you must manually configure it. To manually set up your mail client, first,  navigate to the Set up Mail Client interface , then use the following settings:

Secure SSL/TLS Settings (Recommended)

Setting
Description
Values
Username
The username on the mail account.
Password
The password for the mail account.
The mail account’s password.
Incoming Server Port
The port the system uses for incoming mail.
  • IMAP Port: 993
  • POP3 Port: 995
Incoming Server
The mail server address the system uses for incoming mail.
Outgoing Server Port (SMTP)
The port the system uses for outgoing mail.
465
Outgoing Server
The mail server the system uses for outgoing mail.

Secure SSL/TLS settings

The system generates the email account’s Incoming Server and Outgoing Server hostname based on the domain’s SSL certificate status:
  • If the account has a valid SSL certificate installed, the system uses the email account’s domain.
  • If the domain does not have a valid SSL certificate installed, the system uses the server’s hostname for the email account. For example, if your hostname is www.example.com and your SSL certificate matches your hostname, the system uses the www.example.com server name.
Important
We strongly recommend that you use the Secure SSL/TLS setting. This setting provides increased security.

Non-SSL Settings (NOT Recommended)

Setting
Description
Values
Username
The username on the mail account.
Password
The password for the mail account.
The mail account’s password.
Incoming Server Port
The port the system uses for incoming mail.
  • IMAP Port: 143
  • POP3 Port: 110
Incoming Server
The mail server address the system uses for incoming mail.
Outgoing Server Port (SMTP)
The port the system uses for outgoing mail.
587
Outgoing Server
The mail server the system uses for outgoing mail.

Non-SSL settings

If you did not install an SSL certificate, the server uses the mail subdomain of your domain for the Incoming Server and Outgoing Server settings. For example, mail.example.com. The system also uses the mail subdomain of your domain if the certificate does not match your hostname.
For more detailed information on setting up your specific mail client, read your mail client’s documentation.

Email Instructions

You can easily send the same configuration instructions that are in the Mail Client Manual Settings section of the interface to a different email address. Enter the desired email address in the text box, then click Send.
Note
For more information on how to troubleshoot your email account, read our  cPanel Common Questions - Email  documentation.