Set Up Mail Client
Valid for versions 96 through the latest version
Version:
96
Last modified: September 30, 2024
Looking for this interface?
Your hosting provider can enable or disable this interface in WHM's Feature Manager interface (WHM >> Home >> Packages >> Feature Manager).
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:
- Navigate to cPanel’s Email Accounts interface (cPanel » Home » Email » Email Accounts).
- Locate 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:
- Navigate to cPanel’s Email Accounts interface (cPanel » Home » Email » Email Accounts).
- Click Connect Devices next to the account whose emails you want the mail client to receive. The Set Up Mail Client interface will appear.
- Locate your mail client in the Application section.
Note:
If you do not see your mail client, you must manually configure it.
- Select 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.Important:We strongly recommend that you use the Secure SSL/TLS setting. This setting provides increased security.
- Review the system’s instructions, then click Proceed to continue. The system will then attempt to download the script.
Important:
Clicking 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.
- Run 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.
- The system may ask if you are sure you want to install the script. Select Continue or Yes to continue the installation.
- The 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.
- 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. | [email protected] |
Password | The password for the mail account. | The mail account’s password. |
Incoming Server Port | The port the system uses for incoming mail. |
|
Incoming Server | The mail server address the system uses for incoming mail. | mail.example.com |
Outgoing Server Port (SMTP) | The port the system uses for outgoing mail. | 465 |
Outgoing Server | The mail server the system uses for outgoing mail. | mail.example.com |
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 thewww.example.com
server name.
Non-SSL Settings (NOT Recommended)
Setting | Description | Values |
---|---|---|
Username | The username on the mail account. | [email protected] |
Password | The password for the mail account. | The mail account’s password. |
Incoming Server Port | The port the system uses for incoming mail. |
|
Incoming Server | The mail server address the system uses for incoming mail. | mail.example.com |
Outgoing Server Port (SMTP) | The port the system uses for outgoing mail. | 587 |
Outgoing Server | The mail server the system uses for outgoing mail. | mail.example.com |
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.
For more information on how to troubleshoot your email account, read our cPanel Common Questions - Email documentation.