1. cPanel & WHM Documentation
  2. cPanel
  3. Email
  4. Set Up Mail Client
email cpanelui

Set Up Mail Client

Valid for versions 110 through the latest version

Version:

110

Last modified: December 4, 2024

Looking for this interface?
Note:

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:

  1. Navigate to cPanel’s Email Accounts interface (cPanel » Home » Email » Email Accounts).
  2. 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 the following clients:

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

  1. Navigate to cPanel’s Email Accounts interface (cPanel » Home » Email » Email Accounts).
  2. Click Connect Devices next to the account whose emails you want the mail client to receive. The Set Up Mail Client interface will appear.
  3. Locate your mail client in the Application section.
    Note:

    If you do not see your mail client, you must manually configure it.

  4. 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.

  5. 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.

  6. 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.
  7. The system may ask if you are sure you want to install the script. Select Continue or Yes to continue the installation.
  8. 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.

  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, use the following settings:

Note:
  • We recommend that you use the IMAP port for incoming mail. If you use the POP3 port, your mail client will download all of the account’s email messages, then remove the messages from the server. You will not be able to access those messages from any other mail client.
  • Replace username and example.com with your email account’s username and domain.

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.
  • IMAP Port: 993
  • POP3 Port: 995
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 the www.example.com server name.
Important:
We strongly recommend that you use the Secure SSL/TLS setting. This setting provides increased security.

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.
  • IMAP Port: 143
  • POP3 Port: 110
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.

Note:

For more information on how to troubleshoot your email account, read our cPanel Common Questions - Email documentation.