Connecting a Custom Domain to Icewarp Cloud (more than 300 users)

This guide explains how to connect your own custom domain to IceWarp Cloud.

After completing the setup, you will be able to create user accounts under your domain and use IceWarp Cloud to send and receive email.

The procedure is intended for IceWarp Cloud administrators managing instances with more than 300 users.

BEFORE YOU BEGIN
These steps are necessary to check before you make any changes to your DNS records.

• identify what is the domain you want to set up and run (please note that you must be an owner of such domain)
• identify your domain name registrar

ADD YOUR CUSTOM DOMAIN
Follow the steps below to set up your DNS records successfully.

• Create your domain
  (navigate to the top left + sign and select New domain, enter the name and press Save)

• Navigate to your registrar’s DNS console and enter the following DNS records below (for example, GoDaddy, HostGator, HostMonster, BlueHost, Network Solutions, NameCheap, Gandi, Hover, or DreamHost)

DNS RECORD - A record

A records allow you to choose which URLs will open webmail when typed into your internet browser. We have chosen the most usual ones (mail, webmail, webclient), but it is up to you which one you want to use (enter only the one you want to use, for example, "mail"). However, the autodiscover record must be typed exactly as shown. You will learn more about autodiscover further in this article. 

DNS RECORD - MX

A mail exchanger record (MX) specifies the mail server responsible for accepting email messages.

DNS RECORD - SRV (AUTODISCOVER)

Autodiscover record is needed for an easy login into external clients such as mobile phones. You can learn more about Autodiscover in our article.

DNS RECORDS - SPF

SPF - The Sender Policy Framework can specify which IP addresses and/or hostnames are authorized to send emails from the specific domain. This example record contains only an MX server. You can create your record with wizard at www.spfwizard.net.

DNS RECORD - DKIM

DKIM creates a domain-level authentication framework for email using private-key technology and a DNS record to prove the source and content of a message.

This record must be created in every domain.

• Head into your webadmin interface and select the domain in which you want to create a DKIM record and select the "Properties" tab and click on the DKIM button
• Now you are able to choose your "selector". Selector helps differentiate different DKIMs on your domain. In case you have multiple DKIM signatures on your domain, please type in a unique selector word. If you do not have another DKIM signature on your domain, you can choose pretty much any word you want. In our case, we will choose "iwdkim".
• Now Let's generate your unique key by clicking on the "GENERATE NEW KEY" button. After that, you are presented with your hostname and unique selector record.
• Copy the values from "HOSTNAME" and "SELECTOR RECORD" to your clipboard and head to your DNS manager on your domain provider.
• Now create a new TXT DNS record in which "HOSTNAME" from the previous step will correspond to the Name of the DNS record and "SELECTOR RECORD" will correspond to the Value of the TXT DNS record. Set the TTL to 3600
• Last but not least, click on the "SAVE" button and confirm the creation of the DKIM.

For example in our case the TXT DNS record would look like this: 

Please note that the value has been shortened for presentation purposes.

You can find out more about DKIM settings in our IceWarp Academy video.

PTR RECORD (rDNS)

On-premise customers must contact their internet service provider of the public IP address to issue the PTR record. When communicating via the SMTP protocol, the pointer record serves as a reverse check of the public hostname.