Dev License: This installation of WHMCS is running under a Development License and is not authorized to be used for production use. Please report any cases of abuse to abuse@whmcs.com

Automatic setup

The email application Microsoft Outlook® (available on Windows and macOS) can automatically detect the email account settings, requiring you to enter just your email address and its password.

Note: For the automatic setup to work, your domain must be pointed to our nameservers. If you use a remote DNS (external nameservers), please assure that the DNS zone and all DNS records are added completely and exactly as on our server. You can find all DNS records of your domain in cPanel under "Zone Editor".

The email account must already exist on the server. If you haven't already, please create the email account first: How to create an email account in cPanel

To attempt the automatic email account setup:

  1. Open the Microsoft Outlook® email application
    • Click on "File" in the navigation bar:



    • Click on the "Add Account" button:



  2. Enter your account's email address. We'll use test@two.ie in this guide.



  3. Click on the "Connect" button.
    Outlook may require 2-3 minutes to find your domain's email settings. You should see the "Adding you@yourdomain.tld" above the "Connect" button while searching for the settings.
  4. If Outlook is able to find the configuration for your domain, it will jump to the next step. Otherwise, it will ask you to select the account type. You can choose either IMAP (recommended) or POP (not recommended):



  5. If the email configuration for your domain was found, the account settings should be pre-filled already, but may still require some corrections. Please refer to the screenshot below (replacing yourdomain.tld with your own domain) or go to the next section of this guide (Manual Setup) that shows you how to find the exact configuration for your domain.



  6. Click on the "Next" button.
  7. Enter the email account password (not the cPanel password or other passwords):



  8. Outlook will check the password and attempt to connect the email account.
  9. Click on the "Done" button to complete the setup.

That's it! Your email account should now be added to Microsoft Outlook and you can send/receive emails through it. You should see a screen (the "Mail" tab) similar to this after you finish:

Manual Setup

Find your email server settings

For the manual setup, you will first need to find the email configuration for your email account / domain. The settings are usually as follows:

Incoming Server

Protocol: IMAP
Hostname: mail.yourdomain.tld (replace yourdomain.tld with your actual domain)
Port: 993
Connection security: SSL/TLS or Autodetect
Authentication method: Normal password or Autodetect
Username: the email address (e.g. you@yourdomain.tld)

Outgoing Server

Hostname: mail.yourdomain.tld (replace yourdomain.tld with your actual domain)
Port: 465 or 587
Connection security: SSL/TLS for port 465, STARTTLS for port 587 or Autodetect if unsure
Authentication method: Normal password or Autodetect
Username: the email address (e.g. you@yourdomain.tld)

To find out the exact settings for your email account / domain, please login to Webmail, scroll down to the "Other Webmail Features" section and click on the "Configure Mail Client" button:

You will then find the email account settings under "Secure SSL/TLS Settings (Recommended)":

Set up the email account in Microsoft Outlook

To add an email account Microsoft Outlook manually, please follow all steps mentioned above for the automatic configuration, but at the 2nd step where you enter the account's email address, click on the "Advanced options" drop-down and select "Let me setup my account manually":

Then simply proceed with the next steps from the automated guide above.

Calendar and Contacts

At the time of this writing (08/05/2023), Microsoft Outlook does not support CalDAV or CardDAV, which are the protocols used by the cPanel Calendar and Contacts Server. This means that calendars and contacts cannot be added to Microsoft Outlook yet.

The alternatives are to use Webmail and/or Mozilla Thunderbird instead, or any other software that supports CalDAV or CardDAV. We have guides for these available here:

Troubleshooting

If you are unable to setup the email account, please assure the following:

  • The email account was added in cPanel: How to create an email account in cPanel
  • The email account password is correct and up to date: How to change the password for your Email Account / Webmail
  • You use the email account password associated to that email account and not the cPanel password.
  • The email settings are correct and match the configuration shown in cPanel / Webmail.
  • Your computer and network have access to the email ports (465, 587, 993, 995)
    • Software firewalls can block these ports and some hardware firewalls or routers may need to have the mail servers white-listed first.
  • The domain name is reachable and has not expired.
  • The domain name points to our nameservers or at least its DNS records for the "mail" sub-domain point to our server.

Should any other issues prevent you from adding the email account, please contact your IT administrator or contact us providing the exact error message or screenshots so we can help you troubleshoot this issue.

Updated by SP on 08/05/2023

Was this answer helpful? 0 Users Found This Useful (0 Votes)

Powered by WHMCompleteSolution