How to configure Airmail 3 for IMAP in macOS

This article assumes that you have already configured a mailbox within a Krystal cPanel account. To carry out the instructions in this article you will need the Manual Settings for your mailbox.

There are now two options for setting up your email client. Option 1 is preferred, but does have some prerequisites.

Option 1 - Use mail.yourdomain for incoming and outgoing mail server (IMAP Hostname and SMTP Hostname) e.g. if your domain is you would use


Your domain’s A record must be pointing to your Krystal hosting server. If your domain is registered with Krystal and you host your website here then this is likely the case.

You must have SSL enabled for the domain. Once your domain is correctly pointing to Krystal a free Let's Encrypt™ certificate will be issued automatically.

If you meet these requirements then you can use the format mail.yourdomain for the inbound (IMAP Hostname) and outbound (SMTP Hostname) mail servers in the instructions below e.g. if your domain is then you would use as the inbound and outbound mail server names.

This option has the benefit of meaning that should you change hosting servers at any point you won’t need to re-configure any email clients. Once the DNS has updated for your new server A record the clients will continue to be able to send and receive email.

Option 2 - use the server hostname for incoming and outgoing mail server

This option has no prerequisites. However, you should be aware that if you use this method, and at a later date change hosting servers you will need to re-configure any email clients.

If you are a reseller this would also impact all your client accounts.
  1. Start the Airmail 3 application from the Dock, or by opening it from the Applications folder.
  2. If this is your first time using Airmail 3, open the application and skip to Step 5.
    If you have previously configured Airmail 3 with other email accounts continue with Step 3.
  3. Select Preferences... from the Airmail 3 menu.
  4. The Airmail 3 Preferences window will open with the Accounts screen pre-selected. Click the + symbol in the bottom left to add a new account followed by New Account.
  5. Select IMAP from the Services drop-down and click Add.
  6. You will now need to enter the account details for the email address you wish to add.
    Enter the information as follows:
    Name: This is the name that will appear to your recipients when you send out email.
    Email: This should be the full mailbox address you created in cPanel.
    Password: This will be the password you set for said mailbox in cPanel.
    Username: This will be the same as the Email field you entered.
    Incoming Server: This should be set to mail.yourdomain or your Home Server name.
    Sending Server: This will be the same as the Incoming Server field.
    Authentication: Checked.
    Username: This will be the same as the Email field you entered.
    Password: This will be the password you set for said mailbox in cPanel.
    Click Add.
  7. AirMail 3 will now auto-discover your account details and add your account.
  8. Once your account has added you will be taken to the inbox. If you have any emails in your account they’ll begin to show. If this is a new email account then your Inbox will be empty until you receive your first email.

How did we do?

Powered by HelpDocs (opens in a new tab)
© Krystal Hosting Ltd 2002–