# 1 - Configure a new e-mail address - Getting started

**Getting Started - How to Configure Your New Email Account**

1. [Add a new Domain & verify it](https://wikidev.emailarray.com/books/3-admin-panel-manage-users-domains-aliases-and-more/page/manage-domains "Manage Domains")
2. [Add a new email address (we call it User)](https://wikidev.emailarray.com/books/3-admin-panel-manage-users-domains-aliases-and-more/page/manage-users "Manage Users")
3. [Transfer your old emails - request a migration (optional step)](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/e-mail-migration "E-mail Migration")
4. [Set up the DNS records](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/dns-configuration "DNS Configuration")
5. [Access your Webmail](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/webmail-access "Webmail client")
6. [Set up your mailbox in your email client](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/chapter/configure-your-favorite-email-app "Setup IMAP or POP on other e-mail clients")
7. [Server names & Ports](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/servers-ports "Servers & Ports")
8. [Cheat Sheet with all the setup details](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/cheat-sheet-with-all-the-details)

The following guides apply to both Basic and Enhanced mailboxes:

# DNS Configuration

<p class="callout info">**DNS Updates**  
It might take some time to see the changes in your DNS based on your provider and domain settings.</p>

<p class="callout warning">**Migrating from another email hosting provider**  
If you are planning an email migration, you may choose to postpone making changes to critical records like MX records until the migration process is complete to avoid any disruption to your current email flow.  
</p>


<p class="callout success">**Cloudflare’s** proxy feature (the Orange Cloud) is designed for web traffic (HTTP/HTTPS) and will interfere with email protocols like IMAP, POP, and SMTP.  
**Action Required**: When adding or editing email records in Cloudflare, ensure the Proxy status is toggled to Off.  
**Visual Indicator**: The cloud icon next to the record should be Grey, not Orange.</p>

### 0. Verify Domain Ownership - TXT Record

Follow [these steps to obtain the details for the Verification TXT Record](https://wikidev.emailarray.com/books/3-admin-panel-manage-users-domains-aliases-and-more/page/manage-domains#bkmrk-verify-domain-owners).

- Navigate to the **[Admin Panel](https://admin.emailarray.com/)**.
- In the side menu, click on **Domains**.
- Click on the **Verify** button (represented by a red checkmark icon).  
      
    [![Admin Panel - step 2 - click on Verify to see the TXT necessary to verify domain ownership - hover.JPG](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/scaled-1680-/admin-panel-step-2-click-on-verify-to-see-the-txt-necessary-to-verify-domain-ownership-hover.JPG)](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/admin-panel-step-2-click-on-verify-to-see-the-txt-necessary-to-verify-domain-ownership-hover.JPG)
- A pop-up window will appear, displaying the **Hostname**, **Type**, and the unique **Value** required for the DNS record.  
      
    [![Admin Panel - step 3 - copy the TXT value for domain verification and add it to your DNS.JPG](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/scaled-1680-/admin-panel-step-3-copy-the-txt-value-for-domain-verification-and-add-it-to-your-dns.JPG)](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/admin-panel-step-3-copy-the-txt-value-for-domain-verification-and-add-it-to-your-dns.JPG)
- You must add a **TXT record** with the following **value**:

<div class="table-wrap" id="bkmrk-type-host-txt-value-"><table class="wrapped confluenceTable tablesorter tablesorter-default" role="grid"><colgroup><col></col><col></col><col></col></colgroup><thead aria-label="Use column header buttons to sort"><tr class="tablesorter-headerRow" role="row"><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" colspan="1" data-column="0" role="columnheader" scope="col"><div class="tablesorter-header-inner"><button class="headerButton">Type</button></div></th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="1" role="columnheader" scope="col">HOST

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="2" role="columnheader" scope="col">TXT Value

</th></tr></thead><tbody><tr role="row"><td class="confluenceTd" colspan="1">TXT</td><td class="confluenceTd">mx-verification

</td><td class="confluenceTd">**The unique string from your Admin Panel pop-up**

</td></tr></tbody></table>

</div>
### 1. MX Records

The first step in configuring your DNS is updating your MX records.

MX records tell the world which server should receive the e-mails sent to your domain and deliver them to the specified e-mail provider, straight to your mailbox. You can usually edit the MX records for your domain from the same Control Panel you use for managing your DNS. You can safely keep your website hosted with another provider and only use our hosting services for the e-mail.

You should first remove all other MX records and then add the following, with the specified preference (the Host value is usually '@'):

<div class="table-wrap" id="bkmrk-type-host%2A-points-to"><table class="wrapped confluenceTable tablesorter tablesorter-default" role="grid"><colgroup><col></col><col></col><col></col><col></col></colgroup><thead aria-label="Use column header buttons to sort"><tr class="tablesorter-headerRow" role="row"><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" colspan="1" data-column="0" role="columnheader" scope="col"><div class="tablesorter-header-inner"><button class="headerButton">Type</button></div></th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" colspan="1" data-column="1" role="columnheader" scope="col"><div class="tablesorter-header-inner"><button class="headerButton">Host\*</button></div></th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="2" role="columnheader" scope="col">Points to

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="3" role="columnheader" scope="col">Priority / Preference

</th></tr></thead><tbody><tr role="row"><td class="confluenceTd" colspan="1">MX</td><td class="confluenceTd" colspan="1">@</td><td class="confluenceTd">mx.emailarray.com

</td><td class="confluenceTd"> 5

</td></tr><tr role="row"><td class="confluenceTd" colspan="1">MX</td><td class="confluenceTd" colspan="1">@</td><td class="confluenceTd">mx2.emailarray.com

</td><td class="confluenceTd"> 10

</td></tr></tbody></table>

</div>**Important:** It is not recommended to create CNAME records within your domain that point to EmailArray MX records and use that CNAME as your MX records.

<p class="callout info">**Update Local Delivery:** Did you temporarily set Local Delivery to "No" to prevent bounced emails? Now that your MX records are updated, it is time to switch it back to **"Yes"**.</p>

**Example configuration for MX records in GoDaddy DNS:**

[![DNS setup for email address - MX records 2.JPG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/dns-setup-for-email-address-mx-records-2.JPG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/dns-setup-for-email-address-mx-records-2.JPG)

### 2. Webmail Record

To access your webmail using a custom URL, you must configure CNAME records within your domain for the webmail host.

You must create:

<div class="table-wrap" id="bkmrk-type-host-points-to-"><table class="wrapped confluenceTable tablesorter tablesorter-default" role="grid"><thead aria-label="Use column header buttons to sort"><tr class="tablesorter-headerRow" role="row"><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" colspan="1" data-column="0" role="columnheader" scope="col"><div class="tablesorter-header-inner"><button class="headerButton">Type</button></div></th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="1" role="columnheader" scope="col">HOST

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="2" role="columnheader" scope="col">Points to

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" colspan="1" data-column="3" role="columnheader" scope="col"><div class="tablesorter-header-inner"><button class="headerButton">Your Webmail URL will be</button></div></th></tr></thead><tbody><tr role="row"><td class="confluenceTd" colspan="1">CNAME</td><td class="confluenceTd">webmail

</td><td class="confluenceTd">webredirect.emailarray.com

</td><td class="confluenceTd" colspan="1">webmail.[yourdomain.com](http://yourdomain.com/)</td></tr></tbody></table>

</div><p class="callout warning">Don't forget to replace **yourdomain.com** with the actual name of your domain.</p>

<p class="callout info">Please allow 30-40 minutes for the Webmail SSL status to update in your Admin Panel domain health page.</p>

**Example configuration for Webmail records in GoDaddy DNS:**

[![DNS setup for email address - webmail records.JPG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/dns-setup-for-email-address-webmail-records.JPG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/dns-setup-for-email-address-webmail-records.JPG)

### 3. SPF Record

The SPF record is necessary, so your e-mail is not marked as Spam. The SPF will help with your e-mail deliverability because it specifies a list of authorized hosts that can send e-mails on behalf of a domain.

First, check for any existing TXT records with SPF.

<u>If you don't have an existing SPF record</u>, you must add a **TXT record** with the following **value** (the host value is usually '@'):

<div class="table-wrap" id="bkmrk-type-host-txt-value--1"><table class="wrapped confluenceTable tablesorter tablesorter-default" role="grid"><colgroup><col></col><col></col><col></col></colgroup><thead aria-label="Use column header buttons to sort"><tr class="tablesorter-headerRow" role="row"><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" colspan="1" data-column="0" role="columnheader" scope="col"><div class="tablesorter-header-inner"><button class="headerButton">Type</button></div></th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="1" role="columnheader" scope="col">HOST

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="2" role="columnheader" scope="col">TXT Value

</th></tr></thead><tbody><tr role="row"><td class="confluenceTd" colspan="1">TXT</td><td class="confluenceTd">@

</td><td class="confluenceTd">**v=spf1 include:[emailarray.com](http://emailarray.com/) -all**

</td></tr></tbody></table>

</div><u>  
If you have an SPF record</u>, you should edit it and insert before the final ***-all*** directive, the following value: **include:[emailarray.com](http://emailarray.com/)**

 **Example configuration for SPF TXT records in GoDaddy DNS:**

[![DNS setup for email address - spf records.JPG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/dns-setup-for-email-address-spf-records.JPG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/dns-setup-for-email-address-spf-records.JPG)

### 4. DKIM Records

To improve e-mail deliverability, you should enable DKIM for your domain from your [Admin Panel](https://admin.emailarray.com/) and then add the records to your DNS.

**DKIM** is an e-mail authentication method designed to detect forged sender addresses in e-mails, a technique often used in phishing and e-mail spam ([Wikipedia](https://en.wikipedia.org/wiki/DomainKeys_Identified_Mail)).

To enable DKIM for your domain:

- Go to the [Admin Panel](https://cp.emailarray.com/admin).
- Log in using your Admin username and password.
- Click on **Domains** in the menu.
- Click on the **DKIM icon** next to the domain you wish to activate DKIM for
- In the new window, switch the **Enable** option to **Yes**. This will generate your DKIM record.
- Update your DNS to include the generated DKIM record as **TXT record** (use the **Host** value for Host and the **Key** value for TXT Value).
- Note it might take some time to propagate in the DNS.

<table id="bkmrk-type-name-%28host%29-val"><thead><tr><th>Type</th><th>Name (Host)</th><th>Value (TXT)</th><th>TTL</th></tr></thead><tbody><tr><td>TXT</td><td>Provided **Host** by Admin Panel</td><td>Provided **Key** by Admin Panel</td><td>3600</td></tr></tbody></table>

### 5. Autodiscover &amp; Autoconfig Records

To simplify the configuration on some desktop &amp; mobile e-mail clients, you should use the Autodiscover / Autoconfig web service records to configure these clients automatically. You have to two **A records** in the DNS for your domain:

<div class="table-wrap" id="bkmrk-a-record-hostname-po"><table class="wrapped confluenceTable tablesorter tablesorter-default" role="grid" style="width: 39.7619%; height: 76px;"><colgroup><col style="width: 66.5122%;"></col><col style="width: 33.4216%;"></col></colgroup><thead aria-label="Use column header buttons to sort"><tr class="tablesorter-headerRow" role="row" style="height: 29.6px;"><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="0" role="columnheader" scope="col" style="height: 29.6px;">A record hostname

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="1" role="columnheader" scope="col" style="height: 29.6px;">Points to

</th></tr></thead><tbody><tr role="row" style="height: 46.4px;"><td class="confluenceTd" style="height: 46.4px;">autodiscover.*yourdomain.com*

</td><td class="confluenceTd" style="height: 46.4px;">69.28.212.195

</td></tr><tr><td>autoconfig.*yourdomain.com*

</td><td>69.28.212.195

</td></tr></tbody></table>

</div>Visit the "[Autodiscover &amp; Autoconfig](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/autodiscover-and-autoconfig)" page for more information.

<p class="callout warning">Don't forget to replace **yourdomain.com** with the actual name of your domain.</p>

<p class="callout info">Please allow 30-40 minutes for the Autodiscover &amp; Autoconfig SSL statuses to update in your Admin Panel domain health page.</p>


### Example Setup in GoDaddy:

[![DNS setup for email address - necessary records.JPG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/dns-setup-for-email-address-necessary-records.JPG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/dns-setup-for-email-address-necessary-records.JPG)

[![DNS setup for email address - MX records 2.JPG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/iIGdns-setup-for-email-address-mx-records-2.JPG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/iIGdns-setup-for-email-address-mx-records-2.JPG)

[![DNS setup for email address - spf records (1).JPG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/dns-setup-for-email-address-spf-records-1.JPG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/dns-setup-for-email-address-spf-records-1.JPG)

[![DNS setup for email address - webmail records (2).JPG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/dns-setup-for-email-address-webmail-records-2.JPG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/dns-setup-for-email-address-webmail-records-2.JPG)

### Example Setup in Cloudflare:

<table data-path-to-node="10" id="bkmrk-record-type-host-%2F-n"><thead><tr><td>**Record Type**</td><td>**Host / Name**</td><td>**Value / Points To**</td><td>**Proxy Status**</td></tr></thead><tbody><tr><td><span data-path-to-node="10,1,0,0">**TXT (Domain Verification)**</span></td><td><span data-path-to-node="10,1,1,0">mx-verification</span></td><td><span data-path-to-node="10,1,2,0"><span data-path-to-node="10,4,2,0">`[Provided Key]`</span></span></td><td><span data-path-to-node="10,1,3,0"><span data-path-to-node="10,3,3,1,0">**<span class="citation-589">DNS Only (Grey Cloud)</span>** </span></span></td></tr><tr><td><span data-path-to-node="10,1,0,0">**MX**</span></td><td><span data-path-to-node="10,1,1,0">`@`</span></td><td><span data-path-to-node="10,1,2,0">`mx.emailarray.com`</span></td><td><span data-path-to-node="10,1,3,0">N/A (MX records are never proxied)</span></td></tr><tr><td><span data-path-to-node="10,2,0,0">**MX**</span></td><td><span data-path-to-node="10,2,1,0">`@`</span></td><td><span data-path-to-node="10,2,2,0">`mx2.emailarray.com`</span></td><td><span data-path-to-node="10,2,3,0">N/A</span></td></tr><tr><td><span data-path-to-node="10,3,0,0">**TXT (SPF)**</span></td><td><span data-path-to-node="10,3,1,0">`@`</span></td><td><span data-path-to-node="10,3,2,0">`v=spf1 include:emailarray.com -all`</span></td><td><span data-path-to-node="10,3,3,1,0">**<span class="citation-589">DNS Only (Grey Cloud)</span>** </span>

</td></tr><tr><td><span data-path-to-node="10,4,0,0">**TXT (DKIM)**</span></td><td><span data-path-to-node="10,4,1,0">`[Provided Host]`</span></td><td><span data-path-to-node="10,4,2,0">`[Provided Key]`</span></td><td><span data-path-to-node="10,4,3,1,0">**<span class="citation-588">DNS Only (Grey Cloud)</span>** </span>

</td></tr><tr><td><span data-path-to-node="10,5,0,0">**CNAME**</span></td><td><span data-path-to-node="10,5,1,0">`webmail`</span></td><td><span data-path-to-node="10,5,2,0">`webredirect.emailarray.com`</span></td><td><span data-path-to-node="10,5,3,1,0">**<span class="citation-587">DNS Only (Grey Cloud)</span>** </span>

</td></tr><tr><td><span data-path-to-node="10,6,0,0">**A**</span></td><td><span data-path-to-node="10,6,1,0">`autodiscover`</span></td><td><span data-path-to-node="10,6,2,0">`69.28.212.195`</span></td><td><span data-path-to-node="10,6,3,1,0">**<span class="citation-586">DNS Only (Grey Cloud)</span>** </span>

</td></tr><tr><td><span data-path-to-node="10,7,0,0">**A**</span></td><td><span data-path-to-node="10,7,1,0">`autoconfig`</span></td><td><span data-path-to-node="10,7,2,0">`69.28.212.195`</span></td><td><span data-path-to-node="10,7,3,1,0">**<span class="citation-585">DNS Only (Grey Cloud)</span>** </span>

</td></tr></tbody></table>

# Webmail Access

For both **Basic** and **Enhanced** mailboxes, our supported Webmail interface is the **Group-Office Webmail**. It’s a complete re-design, very modern and fast, and it works as well on mobile as on the desktop.

---


### How to access your Webmail

The Webmail doesn’t need additional setup, and you can access it from any computer, smartphone, or tablet without installing other applications.

You can access the Webmail in a few ways:

- Option 1: Log in directly to [login.emailarray.com](https://login.emailarray.com/) using your full email address and password.
- Option 2: From your **Admin Panel,** click on the envelope icon on the Users page. **You can save the link and bookmark it to your favorite Browser for quick use in the future.**

[![Admin Panel - how to access the Webmail.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/Bpbadmin-panel-how-to-access-the-webmail.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/Bpbadmin-panel-how-to-access-the-webmail.jpg)

- Option 3: adding to your DNS the Webmail record and using this type of URL in the Browser: **[webmail.mydomain.com](http://webmail.mydomain.com/)** (make sure you replace [mydomain.com](http://mydomain.com/) with your domain name). **[This works only if you have set up the DNS records for the Webmail](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/dns-configuration#bkmrk-2.-webmail-record)**.

---


### How to Switch to the New Webmail?

You need to configure or modify your DNS by pointing ‘[webmail.yourdomain.com](http://webmail.yourdomain.com/)’ to [webredirect.emailarray.com](http://webredirect.emailarray.com/) via a CNAME record.

You would then access your Webmail by visiting [http://webmail.yourdomain.com](http://webmail.yourdomain.com/). **Use the HTTP protocol, and it will be automatically redirected to HTTPS.**

# E-mail Migration

<p class="callout success">**Your inbox, unchanged.** We transfer all your email data, including your specific folder hierarchy, so you can pick up exactly where you left off.</p>


### 1. How to Request an Email Migration

We handle migrations in a multi-step process to ensure everything is transferred over safely before and after you change your MX records.

#### **Step 1: Prepare the Mailboxes**

- **Create the mailboxes** on our side from your Admin Panel or WHMCS.   
    For bulk import (100+ mailboxes), add and verify the domains first, then we can perform a bulk creation of the users from a CSV file (<span style="background-color: rgb(251, 238, 184);">[Download example CSV for **bulk import users**](https://wikidev.emailarray.com/attachments/2)</span>).
- **Set temporary passwords.** We need the current passwords of the mailboxes to perform the migration, but please do not request these from your customers. Instead, set up temporary passwords with the previous provider and inform your customers what passwords to use during the migration. They can continue using the current provider until the MX records are changed.
- **Collect the IMAP server address** of the previous provider. For some providers, like Google Workspace, you will need to enable IMAP access and set up application passwords for each mailbox.

<p class="callout info">**Tip: Managing Local Delivery**   
By default, our system routes emails locally between domains hosted on our servers, even if your MX records still point to your old provider. To avoid delivery errors during your transition, set **Local Delivery** to **No**. You can change this back to **Yes** once all your users are added and your MX records are officially pointed to us.  
</p>

#### **Step 2: Submit Your Request**

- **Batch your requests:** We recommend one ticket per migration batch (1 to 2 domains are the easy to manage, especially for DNS updates and client setups).
- **Open a Support Ticket.** Visit our [Support Portal](https://support.emailarray.com/) and 
    - Choose "3 - Migrations" as the help topic.
    - Mention the domain(s) you're migrating in the ticket subject line (easier to track progress).
    - Schedule it (optional): Use the "Schedule for" field to set a date and time. We treat this as a "do not start before" limit - perfect for after-hours migrations.

- **Attach your migration CSV file:** Include your migration CSV file (<span style="background-color: rgb(251, 238, 184);">[Download example CSV file for **migration**](https://wikidev.emailarray.com/attachments/1)</span>) with:
    
    
    - the email addresses
    - temporary passwords
    - source IMAP server
    - Leave the "Destination Email Address" column completely blank unless the new address is actually changing.

<p class="callout warning">**Note on Trash &amp; Spam:** To keep your new inbox clean, we don't migrate the **Trash** or **Spam** folders by default. If you need us to bring the Trash folder along, just mention it in your support ticket!</p>

#### **Step 3: The Migration Process**

- **Automated updates.** We send automated emails when the migration starts and when it ends.
- **Ticket communication:** You can reply to the ticket anytime. To keep your ticket moving swiftly through our active queue, our team will only reply if we need information or to notify you that a step is complete.
- **Timeframe &amp; Next steps:** Migrations usually take under 24 hours, depending on data size and the old server's speed. Once the initial transfer is done, we will update your ticket with instructions for the next steps.

#### **Step 4: Final Sync and Client Setup**

- **Update the DNS records** (MX, SPF, DKIM, webmail, etc.) for the domains to point to our servers ( use the information in this guide: [DNS Configuration](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/dns-configuration)).
- <p class="callout warning">**Important:** If you temporarily set Local Delivery to "No" before the migration, it is time to switch it back to "Yes" now.</p>
- **Reply to your ticket.** Once your MX records are changed, reply to the migration ticket so we can perform the second migration pass. This catches any residual emails delivered to the old provider during the transition.
- **Setup your email clients** to use the new IMAP and SMTP hostnames. (See Section 4 below).

<div class="confluence-information-macro confluence-information-macro-information conf-macro output-block" data-hasbody="true" data-macro-name="info" id="bkmrk-"><div class="confluence-information-macro-body">  
</div></div>
### 2. Migrating Other Data

We can also import your Contacts, Calendars, Aliases, Forwards, Distribution Lists, and help you carry over your Outlook rules.

- **Contacts and Calendars:** you can import them via email or attach exported .vcf files for contacts and .ics files for calendars to your migration support ticket.
- **Aliases:** <span style="background-color: rgb(251, 238, 184);">[Download an example CSV file for **alias migration**](https://wikidev.emailarray.com/attachments/3)</span>. Fill it out and attach it to your migration ticket.
- **Forwards:** <span style="background-color: rgb(251, 238, 184);">[Download an example CSV file for **forwards migration**](https://wikidev.emailarray.com/attachments/4)</span>. Fill it out and attach it. Add multiple lines for a single user if they have multiple forwards.
- **Distribution Lists:** Create the empty list in your Admin Panel first. Then, [<span style="background-color: rgb(251, 238, 184);">download an example CSV file for **list migration**</span>](https://wikidev.emailarray.com/attachments/5), listing each member on a separate line, and attach it to your ticket.
- **Outlook Rules &amp; Filters:** Your organizational rules are tied to your specific Outlook profile. To keep them, export your rules (.rwz file) from the old Outlook profile via `File > Manage Rules & Alerts > Options > Export Rules`. Once you set up your new profile (see Section 4), import that same file into it.


### 3. What to Expect After Migration

####   
Your Folder Structure &amp; The Auto-Archive Feature

We transfer all your email data and folder hierarchy. However, to ensure your service remains fast and reliable, our system uses an automated optimization tool.

- **The 10,000 Item Threshold**: If any folder contains more than 10,000 emails, our system automatically moves older messages into an archive sub-folder. For example, if your "Inbox" has over 10,000 emails, older messages will be moved to `Archive.Inbox.2023`, `Archive.Inbox.2022`, etc.
- **Why we do this**: This prevents email clients from slowing down or corrupting data files, and keeps webmail searches nearly instantaneous.
- **Current + Last Year:** Active folders retain messages from the current year and the previous year. Older data is safely moved to archives.
- **Full Accessibility**: Archived emails remain fully searchable and accessible across all your devices. If a folder seems to have fewer messages than expected after a migration, simply check the sub-folders for an Archive directory.

<p class="callout info">**Missing emails? Check your archive folders.**  
If you notice a folder has fewer messages than expected after migration, don't worry, your data is safe. Simply check the sub-folders for an Archive directory. All your historical data remains fully searchable and accessible across all your devices.</p>


---



### 4. Updating Your Email Clients

When it is time to connect your email apps (Outlook, Apple Mail, Thunderbird, eM Client, iOS, Android, etc.) to our servers, you must follow this one crucial rule to avoid corrupting your setup or losing your email history.

#### The Golden Rule: Always Add a New Account / Profile

Do not simply edit your existing IMAP or POP profile to change the server names. Overwriting an old profile often causes the setup to fail.

1. Keep your current email account profile untouched as a reference.
2. Add a **completely new account** or **profile** to your app using your new server details.
3. Once the new account is verified, syncing, and set as the default, you can safely delete the old one.

For step-by-step configuration guides for your specific app, please visit: [Setup IMAP on email clients](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/chapter/configure-your-favorite-email-app).


### 5. If You Were Previously Using a POP3 Connection

If you were using a **POP3** connection in Outlook or another email client, your emails are likely stored only on your local computer and not on the previous server.

<p class="callout danger">**Backup First**: Before you begin, export your entire profile as a local backup ( like a **PST file** in Outlook).</p>

- **Local Storage Risk**: Since your computer is the only home for these emails, this backup is critical to prevent permanent data loss.
- **The Transition**: Create your new IMAP profile first. Once active, you can import your old PST/backup file into the new profile to merge your history with the new service.
- **Safety Check**: Do not delete your old account profile until you are 100% sure your data has been successfully imported into the new one.

# Servers & Ports

### Recommended setup for SSL connection:

<p class="callout info">Configuring [<span class="error">Autodiscover &amp; Autoconfig</span>](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/dns-configuration#bkmrk-5.-autodiscover-reco) DNS records for your domain can simplify the configuration of your desktop clients, such as Outlook and Thunderbird.</p>

<table class="confluenceTable tablesorter tablesorter-default stickyTableHeaders" id="bkmrk-protocol-server-addr" role="grid"><thead aria-label="Use column header buttons to sort" class="tableFloatingHeaderOriginal"><tr class="tablesorter-headerRow" role="row"><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="0" role="columnheader" scope="col">Protocol

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="1" role="columnheader" scope="col">Server Address

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="2" role="columnheader" scope="col">Ports

</th></tr></thead><tbody><tr role="row"><td class="confluenceTd">IMAP (Incoming)</td><td class="confluenceTd">imap.emailarray.com

</td><td class="confluenceTd">993

</td></tr><tr role="row"><td class="confluenceTd">SMTP (Outgoing)

</td><td class="confluenceTd">smtp.emailarray.com

</td><td class="confluenceTd">465

</td></tr><tr role="row"><td class="confluenceTd">POP3 (Incoming)

</td><td class="confluenceTd">pop.emailarray.com

</td><td class="confluenceTd">995

</td></tr></tbody></table>

<p class="callout warning">You must enable SMTP Authentication in your e-mail client in order to send e-mails out.</p>

<p class="callout info">Also note that **IMAP is recommended rather than POP**, as it´s a protocol made to support several devices accessing one same account, with all folders synced at our server, which also guarantees that our backups will be executed.</p>


### Other ports are available, for SSL, TLS or non-SSL setup:

#### IMAP Service

<div class="wiki-content" id="bkmrk-encryption-server-ad"><div class="conf-macro output-block" data-hasbody="true" data-macro-name="unmigrated-wiki-markup"><table class="confluenceTable tablesorter tablesorter-default stickyTableHeaders" role="grid"><thead aria-label="Use column header buttons to sort" class="tableFloatingHeaderOriginal"><tr class="tablesorter-headerRow" role="row"><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="0" role="columnheader" scope="col">Encryption

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="1" role="columnheader" scope="col">Server Address

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="2" role="columnheader" scope="col">Ports

</th></tr></thead><tbody><tr role="row"><td class="confluenceTd">SSL

</td><td class="confluenceTd">imap.emailarray.com

</td><td class="confluenceTd">993

</td></tr><tr role="row"><td class="confluenceTd">TLS

</td><td class="confluenceTd">imap.emailarray.com

</td><td class="confluenceTd">143

</td></tr><tr role="row"><td class="confluenceTd">NONE

</td><td class="confluenceTd">imap.emailarray.com

</td><td class="confluenceTd">143

</td></tr></tbody></table>

</div></div>#### SMTP Service

<div class="wiki-content" id="bkmrk-encryption-server-ad-1"><div class="conf-macro output-block" data-hasbody="true" data-macro-name="unmigrated-wiki-markup"><table class="confluenceTable tablesorter tablesorter-default stickyTableHeaders" role="grid"><thead aria-label="Use column header buttons to sort" class="tableFloatingHeaderOriginal"><tr class="tablesorter-headerRow" role="row"><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="0" role="columnheader" scope="col">Encryption

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="1" role="columnheader" scope="col">Server Address

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="2" role="columnheader" scope="col">Ports

</th></tr></thead><tbody><tr role="row"><td class="confluenceTd">SSL

</td><td class="confluenceTd">smtp.emailarray.com

</td><td class="confluenceTd">465

</td></tr><tr role="row"><td class="confluenceTd">TLS

</td><td class="confluenceTd">smtp.emailarray.com

</td><td class="confluenceTd">25,26,587

</td></tr><tr role="row"><td class="confluenceTd">NONE

</td><td class="confluenceTd">smtp.emailarray.com

</td><td class="confluenceTd">25,26,587

</td></tr></tbody></table>

</div></div><table border="1" id="bkmrk-important-you-must-e-1" style="border-collapse: collapse; width: 100%; border-width: 1px; background-color: rgb(255, 253, 246);"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>**Important**

You must enable SMTP Authentication in your e-mail client in order to send e-mails out.

</td></tr></tbody></table>


####  

#### POP3 Service

<table border="1" id="bkmrk-also-note-that%C2%A0imap--1" style="border-collapse: collapse; width: 100%; border-width: 1px; background-color: rgb(243, 249, 244);"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>Also note that **IMAP is recommended rather than POP**, as it´s a protocol made to support several devices accessing one same account, with all folders synced at our server, which also guarantees that our backups will be executed.</td></tr></tbody></table>

<div class="wiki-content" id="bkmrk-encryption-server-ad-2"><div class="conf-macro output-block" data-hasbody="true" data-macro-name="unmigrated-wiki-markup"><table class="confluenceTable tablesorter tablesorter-default stickyTableHeaders" role="grid"><thead aria-label="Use column header buttons to sort" class="tableFloatingHeaderOriginal"><tr class="tablesorter-headerRow" role="row"><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="0" role="columnheader" scope="col">Encryption

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="1" role="columnheader" scope="col">Server Address

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="2" role="columnheader" scope="col">Ports

</th></tr></thead><tbody><tr role="row"><td class="confluenceTd">SSL

</td><td class="confluenceTd">pop.emailarray.com

</td><td class="confluenceTd">995

</td></tr><tr role="row"><td class="confluenceTd">TLS

</td><td class="confluenceTd">pop.emailarray.com

</td><td class="confluenceTd">110

</td></tr><tr role="row"><td class="confluenceTd">NONE

</td><td class="confluenceTd">pop.emailarray.com

</td><td class="confluenceTd">110

</td></tr></tbody></table>

</div></div>

# Autodiscover and Autoconfig

### Autodiscover / Autoconfig for Outlook, Thunderbird &amp; Mobile Devices

#### What is Autodiscover / Autoconfig ?

It's a web services that is used by a growing number of applications and which helps in configuring your mobile devices and desktop clients. Autodiscover / Autoconfig is used by Outlook, Thunderbird, eM Client, iOS &amp; Android devices in order to automatically configure the e-mail application.

This services allow you to configure an e-mail account by only entering your e-mail address and password, without having to worry about incoming servers, outgoing servers, or ports. All communication is configured to be secured through SSL by default. However, the implementation is heavily dependent on the software maker ( Apple, Microsoft ) and some versions have better integrations than others.


#### DNS Configuration

Add an **A** type record in the DNS of the domain for which you'd like to enable this services (**Don't forget to replace yourdomain.com with your actual domain name**):

<div class="table-wrap" id="bkmrk-a-record-hostname-po"><table class="wrapped confluenceTable tablesorter tablesorter-default stickyTableHeaders" role="grid"><colgroup><col></col><col></col></colgroup><thead aria-label="Use column header buttons to sort" class="tableFloatingHeaderOriginal"><tr class="tablesorter-headerRow" role="row"><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="0" role="columnheader" scope="col">A record hostname

</th><th aria-disabled="false" class="confluenceTh tablesorter-header sortableHeader tablesorter-headerUnSorted" data-column="1" role="columnheader" scope="col">Points to

</th></tr></thead><tbody><tr role="row"><td class="confluenceTd">autodiscover.***yourdomain.com***

</td><td class="confluenceTd">69.28.212.195

</td></tr><tr><td>autoconfig.***yourdomain.com***

</td><td>69.28.212.195

</td></tr></tbody></table>

</div><div class="table-wrap" id="bkmrk--1"></div>

# Configure your favorite email app

**Step-by-step guides for IMAP and SMTP setup.**

Whether you prefer the desktop power of Outlook and Thunderbird or the mobility of your smartphone, we’ve got you covered. Pick your platform below for a tailored, step-by-step guide.

**Quick Server Settings:** If you’re an advanced user and just need the "cheat sheet," use these secure settings:

Protocol Server Address Ports

IMAP (Incoming) imap.emailarray.com 993

SMTP (Outgoing) smtp.emailarray.com 465

POP3 (Incoming) pop.emailarray.com 995

**Important**: When setting up your outgoing server (SMTP), always ensure "**Authentication Required**" is enabled using your full email address and password.

**Pro Tip: Use IMAP.** We strongly recommend IMAP over POP3. It keeps all your folders in sync across every device and ensures your data is protected by our 30-day (Basic) or 365-day (Enhanced) backups.

# Setup Email on Thunderbird (IMAP)

Thunderbird is a free, open-source email client that offers excellent support for IMAP and advanced groupware features. Follow the steps below to connect your mailbox.

<span data-path-to-node="6,0">**<span class="citation-713">Large Mailboxes:</span>**<span class="citation-713"> Depending on your internet speed and the size of your mailbox (up to 200GB per account), the initial synchronization can take anywhere from a few hours to a few days to fully build your local data file</span></span><span data-path-to-node="6,1"><span class="citation-713 citation-end-713"><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup></span></span><span data-path-to-node="6,2">.</span>

<p class="callout info"><span data-path-to-node="6,2">You can setup [Autoconfig](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/dns-configuration#bkmrk-5.-autodiscover-reco) in your DNS to make the process of setting up Thunderbird much easier.</span></p>

<p class="callout success"><span data-path-to-node="25,1,0,1">Enhanced mailbox? [<span class="citation-743">Connect a </span>**<span class="citation-743">CardDAV</span>**<span class="citation-743"> address book or a </span>**<span class="citation-743">remote calendar</span>**](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/thunderbird-syncing-contacts-and-calendars)<span class="citation-743">[ (CalDAV) ](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/thunderbird-syncing-contacts-and-calendars)to keep your contacts and schedule in sync.</span></span></p>


### Getting Started

To open the setup window for a new email account:

1. Click on **Account Actions** in the bottom left of the account pane.
2. Select **Add Mail Account...** from the menu.  
      
    [![Thunderbird - Account Actions - Add Mail Account.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/thunderbird-account-actions-add-mail-account.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/thunderbird-account-actions-add-mail-account.PNG)


### Option 1: Automatic Configuration (Recommended)

If you have [**Autoconfig** ](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/dns-configuration#bkmrk-5.-autodiscover-reco)set up in your DNS, Thunderbird will handle the heavy lifting for you.

1. **Enter Your Details:** Fill in your full name, email address, and password. Keep **Remember password** checked.  
      
    [![Thunderbird - Setup - step 1.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/thunderbird-setup-step-1.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/thunderbird-setup-step-1.PNG)
2. **Search for Settings:** Click **Continue**. Thunderbird will automatically search for the recommended server configuration.
3. **Confirm Configuration:** Once the green "Configuration found" message appears, verify that **IMAP** is selected.  
      
    [![Thunderbird - mailbox with autodiscover - server names found.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/thunderbird-mailbox-with-autodiscover-server-names-found.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/thunderbird-mailbox-with-autodiscover-server-names-found.PNG)
4. **Finish Setup:** Click **Done**.

<div class="wiki-content" id="bkmrk-you-can-ask-your-sys"><div class="confluence-information-macro confluence-information-macro-information conf-macro output-block" data-hasbody="true" data-macro-name="info"><div class="confluence-information-macro-body">  
</div></div></div>
### Option 2: Manual Configuration

If Autoconfig is not available or you need to specify custom ports, follow these steps.

1. **Enter Your Details:** Input your name, email, and password, then click **Configure manually** at the bottom of the window.  
      
    [![Thunderbird - Setup - step 1.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/thunderbird-setup-step-1.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/thunderbird-setup-step-1.PNG)
2. **Enter Server Details:** <span data-path-to-node="8,1"><span class="citation-712">We recommend using </span>**<span class="citation-712">IMAP with SSL/TLS</span>**<span class="citation-712"> to ensure your data remains private and your folders stay synchronized across all devices</span></span><span data-path-to-node="8,2"><span class="citation-712 citation-end-712"><sup class="superscript" data-turn-source-index="3"></sup></span></span><span data-path-to-node="8,3">.</span>
    
    
    - Incoming Server
        
        
        - **Protocol**: IMAP
        - **Hostname**: imap.emailarray.com
        - **Port**: 993
        - Connection Security: SSL/TLS
        - Authentication Method: Normal password
        - Username: Your full email address (e.g., name@yourdomain.com)
    - Outgoing Server
        
        
        - **Protocol**: SMTP
        - **Hostname**: smtp.emailarray.com
        - **Port**: 465
        - Connection Security: SSL/TLS
        - Authentication Method: Normal password
        - Username: Your full email address (e.g., name@yourdomain.com)

  
[![Thunderbird - Setup - step 3 - re-test to auto-fill unknown fields like ports and authentication method.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/thunderbird-setup-step-3-re-test-to-auto-fill-unknown-fields-like-ports-and-authentication-method.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/thunderbird-setup-step-3-re-test-to-auto-fill-unknown-fields-like-ports-and-authentication-method.PNG)

1. **Test and Verify:** Click **Re-test**. Thunderbird will verify the connection.
2. **Finalize:** Once the green success bar appears ("The following settings were found by probing the given server"), click **Done**.

### Success!

Your account is now ready to use.

On the final screen, you can also:

- Add a custom signature.
- <span data-path-to-node="25,1,0,1">Enhanced mailbox? [<span class="citation-743">Connect a </span>**<span class="citation-743">CardDAV</span>**<span class="citation-743"> address book or a </span>**<span class="citation-743">remote calendar</span>**](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/thunderbird-syncing-contacts-and-calendars)<span class="citation-743">[ (CalDAV) ](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/thunderbird-syncing-contacts-and-calendars)to keep your contacts and schedule in sync.</span></span>
- Enable end-to-end encryption for extra security.

Click **Finish** to head to your inbox. Thunderbird will now begin synchronizing your folders.

# Setup Email on Outlook (IMAP)

<span data-path-to-node="4,1"><span class="citation-173">Find the step-by-step tutorial for your specific version of Outlook below. </span></span><span data-path-to-node="4,2"><span class="citation-173 citation-end-173"><sup class="superscript" data-turn-source-index="1"></sup></span></span><span data-path-to-node="4,4"><span class="citation-172">If you aren't sure which version you have, you can usually find this info under the </span>**<span class="citation-172">Help</span>**<span class="citation-172"> menu or the </span>**<span class="citation-172">About</span>**<span class="citation-172"> section within the app.</span></span>

<p class="callout info"><span data-path-to-node="4,4"><span class="citation-172">**<span class="citation-165">Large Mailboxes:</span>**<span class="citation-165"> Depending on your internet speed and the size of your mailbox (we support up to 200GB per account), the initial synchronization can take anywhere from a few hours to a few days to fully build your local data file.  
</span></span></span></p>

<p class="callout success"><span data-path-to-node="25,1,0,1">**Enhanced mailbox?** [<span class="citation-743">Connect a </span>**<span class="citation-743">CardDAV</span>**<span class="citation-743"> address book or a </span>**<span class="citation-743">remote calendar</span>**](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/outlook-caldav-synchronizer-setup)<span class="citation-743">[ (CalDAV)](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/thunderbird-syncing-contacts-and-calendars) to keep your contacts and schedule in sync in Outlook.</span></span></p>

<span data-path-to-node="4,4"><span class="citation-172"><span class="citation-165"><span data-path-to-node="7,0">Use the following settings or follow the [Outlook 365](#bkmrk-outlook-365) or [Outlook 2013/2010](#bkmrk-outlook-2013%2F2010%3A) instructions below.</span></span></span></span>

<table border="1" id="bkmrk-service-server-addre" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr><td>Service</td><td>Server Address</td><td>Port (SSL/TLS)</td></tr><tr><td>Incoming (IMAP)</td><td>imap.emailarray.com</td><td>993</td></tr><tr><td>Outgoing (SMTP)</td><td>smtp.emailarray.com</td><td>465</td></tr></tbody></table>

<span data-path-to-node="4,4"><span class="citation-172"><span class="citation-165"><span data-path-to-node="7,2"><span class="citation-285">We recommend using </span>**<span class="citation-285">IMAP with SSL/TLS</span>**<span class="citation-285"> to ensure your data remains private and your folders stay synchronized across all devices</span></span><span data-path-to-node="7,3"><span class="citation-285 citation-end-285"><sup class="superscript" data-turn-source-index="3"></sup><sup class="superscript" data-turn-source-index="3"></sup><sup class="superscript" data-turn-source-index="3"></sup><sup class="superscript" data-turn-source-index="3"></sup><sup class="superscript" data-turn-source-index="3"></sup></span></span><span data-path-to-node="7,4">.</span></span></span></span>

## The New Outlook for Windows

Microsoft has recently introduced a "New Outlook" for Windows. Based on our testing and official Microsoft documentation, this version handles IMAP accounts differently than previous versions.

#### What you need to know

- **Forced Cloud Sync**: Unlike "Classic" Outlook, the "New Outlook" requires all IMAP accounts to sync through the Microsoft Cloud.
- **Data Privacy**: This means your emails, even though hosted securely with us, will be stored on Microsoft’s servers to enable this sync.
- **Setup Failures**: Because Microsoft forces this intermediary sync, many IMAP setups fail during the "Syncing to Microsoft" phase, even if your credentials and server settings are 100% correct.

#### Our Recommendation: Use "Classic" Outlook

To maintain a direct, private connection between your device and our servers, and to avoid setup errors, we recommend staying with **Classic Outlook**.

1. Open Outlook.
2. Locate the **"Try the new Outlook"** toggle in the upper-right corner.
3. Switch the toggle **Off**.
4. Restart Outlook and follow the [Outlook 365](#bkmrk-outlook-365) or [Outlook 2013/2010](#bkmrk-outlook-2013%2F2010%3A) instructions below.

<p class="callout warning">For a deeper dive into why Microsoft implemented this change, you can read the [full discussion on the Microsoft Community page](https://learn.microsoft.com/en-us/answers/questions/4736051/why-wont-new-outlook-for-windows-let-me-configure).</p>

## Outlook 365

<p class="callout info">Unfortunately, this version of Outlook doesn't support **Autodiscover** for IMAP accounts anymore.</p>

<div class="confluence-information-macro-body" id="bkmrk--1"></div><div class="wiki-content" id="bkmrk-click-on-the%C2%A0file-me">- Click on the **File menu**
- Click on **+ Add Account**

</div> **[![Email migration request.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/email-migration-request.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/email-migration-request.jpg) [![Email-setup-example-in-Office-365-Step-0-click-on-the-Add-Account-button.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/email-setup-example-in-office-365-step-0-click-on-the-add-account-button.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/email-setup-example-in-office-365-step-0-click-on-the-add-account-button.jpg)**

<div class="wiki-content" id="bkmrk-fill-in-your-full%C2%A0em">- Fill in your full **email address** and select the option **Let me set up my account manually**.
- Click on **Next**.

</div> [![Email-setup-example-in-Office-365-Step-1-fill-in-your-email-address.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/email-setup-example-in-office-365-step-1-fill-in-your-email-address.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/email-setup-example-in-office-365-step-1-fill-in-your-email-address.jpg)

<div class="wiki-content" id="bkmrk-select%C2%A0imap%C2%A0from-the">- Select **IMAP** from the list of account types.

</div> [![Email-setup-example-in-Office-365-Step-2-select-IMAP-as-account-type.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/email-setup-example-in-office-365-step-2-select-imap-as-account-type.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/email-setup-example-in-office-365-step-2-select-imap-as-account-type.jpg)

<div class="wiki-content" id="bkmrk-fill-in-server-infor">- Fill in server information from the [Server &amp; Ports page](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/servers-ports)
- Click on **Next**

</div> [![Email-setup-example-in-Office-365-Step-3-fill-in-the-account-server-settings.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/email-setup-example-in-office-365-step-3-fill-in-the-account-server-settings.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/email-setup-example-in-office-365-step-3-fill-in-the-account-server-settings.jpg)

<div class="wiki-content" id="bkmrk-fill-in-your-existin">- Fill in your existing **password** for your email address and click on **Connect**

</div> **[![Email-setup-example-in-Office-365-Step-4-fill-in-the-existing-password-for-your-email-address.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/email-setup-example-in-office-365-step-4-fill-in-the-existing-password-for-your-email-address.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/email-setup-example-in-office-365-step-4-fill-in-the-existing-password-for-your-email-address.jpg)**

<div class="wiki-content" id="bkmrk-the-setup-is-complet">- The setup is completed. The message **Account successfully added** will show and Outlook will begin synchronizing the account.

</div><p class="callout info">Depending on the size of your mailbox and your Internet speed, Outlook might take from a few hours to a few days to synchronize the mailbox and build the local PST file.</p>


## Outlook 2013/2010:

<div class="wiki-content" id="bkmrk-click-on-the%C2%A0file-me-1">- Click on the **File menu**
- Click on **+ Add Account**

</div> **[![Add-email-address-to-an-email-client-Outlook-2013.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/add-email-address-to-an-email-client-outlook-2013.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/add-email-address-to-an-email-client-outlook-2013.jpg)**

<div class="wiki-content" id="bkmrk-select%C2%A0pop-or-imap">- Select **POP or IMAP**

</div> <span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">[![Add-email-address-to-an-email-client-Outlook-2013-POP-or-IMAP.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/add-email-address-to-an-email-client-outlook-2013-pop-or-imap.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/add-email-address-to-an-email-client-outlook-2013-pop-or-imap.jpg)</span>**

<div class="wiki-content" id="bkmrk-option-1%3A-this-versi">- **Option 1**: this version of Outlook supports Autodiscover for IMAP accounts if you have [setup Autodicover in your DNS](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/autodiscover-and-autoconfig). 
    - Type in your full name, e-mail address, and password and click on **Next**
    - Click on **Allow** when asked about autodiscover.xml
    - Click on **Finish**

</div><div class="wiki-content" id="bkmrk-option-2%3A-if-you-don">- **Option 2**: If you don't have Autodicover 
    - select **Manual setup** and click on **Next**.

</div> [![Add-email-address-to-an-email-client-Outlook-2013-2.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/add-email-address-to-an-email-client-outlook-2013-2.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/add-email-address-to-an-email-client-outlook-2013-2.jpg)

<div class="wiki-content" id="bkmrk-type-in-your-full-na">- - Type in your full name, e-mail address, and password
    - Fill in server information from the [Server &amp; Ports page](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/servers-ports)

</div> [![Add-email-address-to-an-email-client-Outlook-2013-4-selected.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/add-email-address-to-an-email-client-outlook-2013-4-selected.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/add-email-address-to-an-email-client-outlook-2013-4-selected.jpg)

<div class="wiki-content" id="bkmrk-click-on%C2%A0more-settin">- - Click on **More Settings**.
    - Select **My outgoing server (SMTP) requires authentication** and **Use same settings as my incoming mail server**.

</div> [![Add-email-address-to-an-email-client-Outlook-2013-5-options.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/add-email-address-to-an-email-client-outlook-2013-5-options.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/add-email-address-to-an-email-client-outlook-2013-5-options.jpg)

<div class="wiki-content" id="bkmrk-click-on-the%C2%A0advance">- - Click on the **Advanced** tab
    - Verify the ports are correct and SSL is selected.

</div> [![Add-email-address-to-an-email-client-Outlook-2013-6-options.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/add-email-address-to-an-email-client-outlook-2013-6-options.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/add-email-address-to-an-email-client-outlook-2013-6-options.jpg)

<div class="wiki-content" id="bkmrk-click-on%C2%A0ok.-click-o">- - Click on **OK**. Click on **Next** to finish the setup.

</div><p class="callout info">Depending on the size of your mailbox and your Internet speed, Outlook might take from a few hours to a few days to synchronize the mailbox and build the local PST file.</p>

<div class="wiki-content" id="bkmrk--6"><div class="confluence-information-macro confluence-information-macro-information conf-macro output-block" data-hasbody="true" data-macro-name="info"><div class="confluence-information-macro-body">  
</div></div></div>

# Setup Email on iOS

<p class="callout info">If you have an **Enhanced** mailbox, you can use ActiveSync, to not only sync emails, but also contacts and calendars.</p>

### Automatic Email Setup for iOS

The easiest way to setup your mailbox on iOS is by downloading your iOS profile from the Webmail. The profile will include email, calendars and contacts if you have an **Enhanced** mailbox, or just the email if you have a **Basic** mailbox. Alternatively, you can use the steps for manual setup.

Here are the steps for automatic email setup on your iOS device:

- From your iOS device login to your [Webmail](https://login.emailarray.com/).
- Click on your profile image and click on **Download iOS Profile** from the dropdown menu. This option will only appear if you are logged in from an iOS device.  
      
    [![Webmail options on iOS - download iOS profile for easy mailbox setup on your iPhone, iPad.png](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/webmail-options-on-ios-download-ios-profile-for-easy-mailbox-setup-on-your-iphone-ipad.png)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/webmail-groupoffice-go-to-my-account-settings.jpg)

- A pop-up message will appear with the message **Configuration profile available - Continue downloading?** Click on the **Continue** button or confirm the download.
- After the profile is downloaded, a confirmation pop-up will show with the message **Profile Downloaded - Review the profile in the Settings app if you want to install it.**   
      
    [![iOS - Email profile downloaded confirmation popup.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/ios-email-profile-downloaded-confirmation-popup.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/ios-email-profile-downloaded-confirmation-popup.jpg)
- Go to your iOS device **Settings** and you should see a new menu item on the left hand with the text **Profile Downloaded**. Click on it.  
      
    [![iOS - Settings with the new Profile Downloaded menu option.png](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/ios-settings-with-the-new-profile-downloaded-menu-option.png)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/ios-settings-with-the-new-profile-downloaded-menu-option.png)
- A new window with **Install Profile** will show. Click on the **Install** button.  
      
    [![iOS - Confirm email account installation on your device using the downloaded profile.png](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/ios-confirm-email-account-installation-on-your-device-using-the-downloaded-profile.png)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/ios-confirm-email-account-installation-on-your-device-using-the-downloaded-profile.png)
- Next, depending on your mailbox type, it will ask you to enter your mailbox password for **Incoming Mail Server**. Enter your mailbox password.
- And you're all done! The mailbox has been added to your iOS device and you can check the emails using the email app.

### Manual IMAP Setup for iOS

Here's the step by step for setting up an IMAP account on iOS.

- Click on **Settings**
- Click on **Mail, Contacts, Calendars**
- Click on **Add Account**
- Click on **Other**
- Click on **Add Mail Account**
- Inform the following 
    - **Name** - The display name you want on your outgoing email
    - **Email** - Your full email address
    - **Password** - Your email password
    - **Description** - A description for your account
- Click on **Next**
- IMAP is selected by default
- Under **Incoming Mail Server**, enter as below: 
    - **Host Name** - `imap.emailarray.com`
    - **User Name** - Your full e-mail address
    - **Password** - Your password
- Under **Outgoing Mail Server**, enter as below: 
    - **Host Name** - `smtp.emailarray.com`
    - **User Name** - Your full e-mail address
    - **Password** - Your password
- Click on **Next**
- Click on **Save**

<p class="callout info">Note that IMAP is preferred over POP. If you want to set up the account as POP, you have to set it up manually. IMAP is a protocol made to support several devices accessing one same account, with all folders synced at our server, which also guarantees that our backups will be executed.</p>


### Example setup for iOS:

<table border="1" id="bkmrk--2" style="border-collapse: collapse; width: 102.381%; height: 161px;"><colgroup><col style="width: 16.6865%;"></col><col style="width: 16.6865%;"></col><col style="width: 16.6865%;"></col><col style="width: 16.6865%;"></col><col style="width: 16.6865%;"></col><col style="width: 16.6865%;"></col></colgroup><tbody><tr><td><span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">[![Apple-Mail-1-Add-Account-use-Other-for-IMAP.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/apple-mail-1-add-account-use-other-for-imap.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/apple-mail-1-add-account-use-other-for-imap.jpg)</span></td><td><span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">[![Apple-Mail-2-Add-Account-fill-in-your-existing-email-address-password-and-name.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/apple-mail-2-add-account-fill-in-your-existing-email-address-password-and-name.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/apple-mail-2-add-account-fill-in-your-existing-email-address-password-and-name.jpg)</span></td><td><span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">[![Apple-Mail-3-Add-Account-fill-in-advanced-setup-details-incoming-and-outgoing-mail-server-and-your-email-password.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/apple-mail-3-add-account-fill-in-advanced-setup-details-incoming-and-outgoing-mail-server-and-your-email-password.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/apple-mail-3-add-account-fill-in-advanced-setup-details-incoming-and-outgoing-mail-server-and-your-email-password.jpg)</span></td><td><span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">[![Apple-Mail-4-Add-Account-choose-to-sync-your-mail.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/apple-mail-4-add-account-choose-to-sync-your-mail.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/apple-mail-4-add-account-choose-to-sync-your-mail.jpg)</span></td><td><span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">[![Apple-Mail-Verify-Account-IMAP-settings-use-SSL-auhtenticate-with-password-and-set-IMAP-server-port-to-993.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/apple-mail-verify-account-imap-settings-use-ssl-auhtenticate-with-password-and-set-imap-server-port-to-993.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/apple-mail-verify-account-imap-settings-use-ssl-auhtenticate-with-password-and-set-imap-server-port-to-993.jpg)</span></td><td><span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">[![Apple-Mail-Verify-Account-SMTP-settings-use-SSL-auhtenticate-with-password-and-set-SMTP-server-port-to-465.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/apple-mail-verify-account-smtp-settings-use-ssl-auhtenticate-with-password-and-set-smtp-server-port-to-465.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/apple-mail-verify-account-smtp-settings-use-ssl-auhtenticate-with-password-and-set-smtp-server-port-to-465.jpg)</span></td></tr></tbody></table>

# Setup Email on Android (IMAP)

Remember that, if you have an Enhanced account, you can use ActiveSync, to not only sync e-mails, but also contacts and events.

### How to set up your email on an Android device

Here's the step by step for setting up an IMAP account on Android's native mail app.

<div class="wiki-content" id="bkmrk-press-the-device%27s%C2%A0m">- Press the device's **Menu** button.
- Tap **Settings**.
- Go to **Manage Accounts**
- Click on **Add account**.
- Click on **Email / Personal (IMAP)**
- **Username**: enter your full e-mail address
- If an account type is asked, choose **IMAP account**.
- **Password**: enter your email's password.
- **Incoming server settings**
    - Username: your full email address
    - Password: your email's password
    - Server: `imap.emailarray.com` . Android will automatically use yourdomain.com as host and you need to change it.
- **Outgoing server settings**
    - Require signin: **YES**
    - Username: your full email address
    - Password: your email's password
    - SMTP server: `smtp.emailarray.com` . Android will automatically use yourdomain.com as host and you need to change it.
- Account options: Optionally, you can set up specific details such as interval for checking mail, if you want to be notified, etc.
- On the last page, Android gives you the option to change the *Account name* (will appear in your list) and *Your name* (will appear to recipients).
- Click on **Next** to finalize the procedure.

</div><div class="wiki-content" id="bkmrk-imap-server---imap.e"></div><table border="1" id="bkmrk-note-that-imap-is-pr" style="border-collapse: collapse; width: 100%; border-width: 1px; background-color: rgb(255, 253, 246);"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>Note that IMAP is preferred over POP. If you want to set up the account as POP, you have to set it up manually. IMAP is a protocol made to support several devices accessing one same account, with all folders synced at our server, which also guarantees that our backups will be executed.</td></tr></tbody></table>

### Example Setup on Android Mail App

[![Android - Email setup - step 1.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/scaled-1680-/android-email-setup-step-1.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/android-email-setup-step-1.jpg)[![Android - Email setup - step 2.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/scaled-1680-/android-email-setup-step-2.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/android-email-setup-step-2.jpg)![Android - Email setup - step 3.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/scaled-1680-/android-email-setup-step-3.jpg)[![Android - Email setup - step 4.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/scaled-1680-/android-email-setup-step-4.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/android-email-setup-step-4.jpg)

[![Android - Email setup - step 5.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/scaled-1680-/android-email-setup-step-5.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/android-email-setup-step-5.jpg)[![Android - Email setup - step 6.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/scaled-1680-/android-email-setup-step-6.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/android-email-setup-step-6.jpg)[![Android - Email setup - step 7.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/scaled-1680-/android-email-setup-step-7.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/android-email-setup-step-7.jpg)[![Android - Email setup - step 8.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/scaled-1680-/android-email-setup-step-8.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2025-06/android-email-setup-step-8.jpg)

# Setup Email on eM Client (IMAP)

eM Client provides a modern, intuitive interface for managing your communications. This guide will walk you through setting up your mailbox using **Automatic Setup** (recommended) or manual configuration.

As with our other desktop guides, we recommend using **IMAP with SSL/TLS** to ensure your data stays synchronized across all your devices and is protected by our professional backups.

<p class="callout success">Syncing Other Services: <span data-path-to-node="13,0">eM Client is a full groupware suite. </span><span data-path-to-node="13,2"><span class="citation-832">If you have an </span>**<span class="citation-832">Enhanced</span>**<span class="citation-832"> mailbox, you can also add your </span>**<span class="citation-832">Calendar (CalDAV)</span>**<span class="citation-832"> and </span>**<span class="citation-832">Contacts (CardDAV)</span>**<span class="citation-832"> directly through the setup wizard to keep your professional life in sync</span></span><span data-path-to-node="13,3"><span class="citation-832 citation-end-832"><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup></span></span><span data-path-to-node="13,4">.</span></p>

## Option 1: Automatic Setup (Recommended)

If your DNS is configured with Autodiscover, eM Client can automatically detect your server settings in seconds.

1. **Start the Wizard:** Open eM Client and go to **Menu &gt; Accounts**. Click on **Add Account**.
2. **Enter Email:** In the **Automatic Setup** section, enter your full email address and click **Start**.  
      
    [![eM Client - email setup - step 1.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-email-setup-step-1.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-email-setup-step-1.PNG)
3. **Account Details:** Enter the name you want recipients to see when you send an email (e.g., "John Smith") and an account name for your internal list. Click **Next**.   
      
    [![eM Client - email setup - step 2.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-email-setup-step-2.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-email-setup-step-2.PNG)
4. **Encryption:** You will be asked about PGP encryption. For most users, we recommend selecting **Continue without encryption** unless you specifically require PGP technology. Click **Next**.  
      
    [![eM Client - email setup - step 3.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-email-setup-step-3.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-email-setup-step-3.PNG)
5. Choose your synchronization options (e.g., "Last 3 days" for faster initial setup) and click **Finish**.  
      
    [![eM Client - email setup - step 4.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-email-setup-step-4.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-email-setup-step-4.PNG)
6. **Authentication:** A window will appear asking for your credentials. Enter your email password and click **OK**. Ensure "Save password" is checked to avoid repeated prompts.

## Option 2: Manual Configuration

If you need to enter settings manually or want to use specific ports, follow these steps:

1. **Select Mail:** In the New Account window, instead of Automatic Setup, click the **Mail** tab and select **Other**. Click **Next**.  
      
    [![eM Client - manual email setup - step 1.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-manual-email-setup-step-1.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-manual-email-setup-step-1.PNG)
2. **Incoming Server:** Select **IMAP**
    
    
    - **Hostname:** `imap.emailarray.com`
    - **User name:** Your full email address.
    - **Password:** Your email account password.
    - **Port:** 993
    - **Security:** SSL/TLS  
          
        [![eM Client - manual email setup - step 3.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-manual-email-setup-step-3.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-manual-email-setup-step-3.PNG)
3. **Outgoing Server:**
    
    
    - **Hostname:** `smtp.emailarray.com`
    - **User name:** Your full email address.
    - **Password:** Your email account password.
    - **Port:** 465
    - **Security:** SSL/TLS  
          
        [![eM Client - manual email setup - step 4.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-manual-email-setup-step-4.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-manual-email-setup-step-4.PNG)
4. **Test Configuration:** eM Client will verify both the SMTP and IMAP connections. Once you see the green **"Ok"** status for both, click **Next**.  
      
    [![eM Client - manual email setup - step 5.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-manual-email-setup-step-5.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-manual-email-setup-step-5.PNG)
5. **Account Details:** Enter your name (as it should appear on sent mail) and an internal account name. Click **Next**.  
      
    [![eM Client - manual email setup - step 6.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-manual-email-setup-step-6.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-manual-email-setup-step-6.PNG)
6. **Encryption:** Select **Continue without encryption** and click **Next**.  
      
    [![eM Client - manual email setup - step 7.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-manual-email-setup-step-7.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-manual-email-setup-step-7.PNG)
7. **Finish:** Choose your message sync time period (e.g., **"All time"**) and click **Finish**.  
      
    [![eM Client - manual email setup - step 8.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-manual-email-setup-step-8.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-manual-email-setup-step-8.PNG)

# ActiveSync / EAS - Sync Email, Calendars and Contacts

### Sync your email, calendar, and contacts in real-time.

**ActiveSync** is the most powerful way to connect your mailbox to your mobile devices and desktop apps. Unlike standard email setups, ActiveSync provides a "push" connection that synchronizes your **email, calendar, contacts, and notes** instantly across all your devices. When you delete an email on your phone, it’s gone from your computer; when you add a meeting to your calendar, it appears everywhere.

<p class="callout info">**Note:** ActiveSync is a premium feature available for **Enhanced mailboxes**.  
</p>

<p class="callout success">**Pro Tip:** If your configured [Autodiscover](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/dns-configuration#bkmrk-5.-autodiscover-reco) in your domain’s DNS settings, you can often skip the manual server entry. Simply enter your email and password, and the device will find the correct server settings automatically.</p>

#### Pre-requisites

Before starting, ensure you have the following details ready:

- **Your Full Email Address:** (e.g., john@mydomain.com).
- **Your Password:** The same password you use for webmail.
- You have added the [Autodiscover DNS record for your domain](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/dns-configuration#bkmrk-5.-autodiscover-reco) to simplify the configuration. Otherwise, you can use the manual setup.


#### Step 1: Add a New Account

1. Open the **Settings** app on your smartphone or tablet.
2. Navigate to **Mail** or **Accounts** and select **Add Account**.
3. From the list of account types, select **Exchange**, **Microsoft Exchange**, or **ActiveSync**.

#### Step 2: Enter Account Details

Simply enter your email and password, and the device will find the correct server settings automatically. Click on **Sign In** or **Finish**.

#### Example setup on Android with Autodiscover:

<table border="1" id="bkmrk--1" style="border-collapse: collapse; width: 100.063%;"><colgroup><col style="width: 49.8418%;"></col><col style="width: 49.8418%;"></col></colgroup><tbody><tr><td>[![Activesync - EAS - on Android - step 1 - choose Exchange type.png](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/activesync-eas-on-android-step-1-choose-exchange-type.png)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/activesync-eas-on-android-step-1.jpg)  
</td><td>[![Activesync - EAS - on Android - step 2.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/activesync-eas-on-android-step-2.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/activesync-eas-on-android-step-2.jpg)</td></tr></tbody></table>

### Manual Setup


#### Step 1: Add a New Account

1. Open the **Settings** app on your smartphone or tablet.
2. Navigate to **Mail** or **Accounts** and select **Add Account**.
3. From the list of account types, select **Exchange**, **Microsoft Exchange**, or **ActiveSync**.

#### Step 2: Enter Account Details

Enter your **email** and **password**. Click on **Manual Setup**.


#### Step 3: Enter Server Settings

- **Server:** Use your domain name in this format: `yourdomain--com.w.emailarray.com`.  
     **Server Address Formula** To create your server address, take your domain name and:
    
    
    1. Replace any **dots (.)** with **two dashes (--)**.
    2. Add **.w.emailarray.com** to the end.
    
    **Example:** If your email is `john@my-company.com`, your server is:   
    `my-company--com.w.emailarray.com`.

- **Domain:** Leave this blank (unless your specific device requires it).
- **Username:** Your **full email address**.
- **Password:** Your email account password.
- **SSL:** Ensure "Use SSL" is turned **ON**.

Click on **Sign In**, **Continue** or **Finish**.


#### Example Setup on Android for Manual Setup:

<table border="1" id="bkmrk--2" style="border-collapse: collapse; width: 100.063%;"><colgroup><col style="width: 33.2278%;"></col><col style="width: 33.2278%;"></col><col style="width: 33.2278%;"></col></colgroup><tbody><tr><td>[![Activesync - EAS - on Android - step 1 - choose Exchange type.png](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/activesync-eas-on-android-step-1-choose-exchange-type.png)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/activesync-eas-on-android-step-1-choose-exchange-type.png)</td><td>[![Activesync - EAS - on Android - step 2.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/activesync-eas-on-android-step-2.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/activesync-eas-on-android-step-2.jpg)</td><td>[![Activesync - EAS - on Android - manual setup.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/activesync-eas-on-android-manual-setup.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/activesync-eas-on-android-manual-setup.jpg)</td></tr></tbody></table>

# Creating a New Outlook Profile

When you switch email providers, it’s tempting to take the shortcut: simply going into your existing account settings and swapping out the IMAP server addresses. While this is technically faster, it’s a strategy that often leads to significant technical headaches.

#### The Risk of the "Quick Change"

Modifying the server records on an existing account frequently leads to **.PST or .OST file corruption**. Because Outlook is trying to map a new server structure onto an old data file, you might encounter missing emails, broken search functionality, or a complete "Send/Receive" failure.

In fact, **Microsoft officially recommends against modifying existing account settings** when moving to a new service. To ensure your data stays intact and your software remains stable, the best practice is to create a **New Outlook Profile**.

### Step 1: Accessing the Mail Setup

Before opening Outlook, we need to go through the Windows Control Panel to manage your profiles.

1. Open the **Control Panel** on your Windows machine.
2. Search for and click on **Mail (Microsoft Outlook)**.
3. In the window that appears, click the **Show Profiles...** button.
4. Click **Add...**, give your new profile a name (e.g., "Work Fresh"), and click **OK**.
    
    <table border="1"><colgroup><col></col><col></col></colgroup><tbody><tr><td>[![Windows - Mail (Outlook) - Add a new Profile.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-02/scaled-1680-/windows-mail-outlook-add-a-new-profile.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-02/windows-mail-outlook-add-a-new-profile.PNG)  
    </td><td>[![Windows - Mail (Outlook) - Add a new Profile - step 2.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-02/scaled-1680-/windows-mail-outlook-add-a-new-profile-step-2.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-02/windows-mail-outlook-add-a-new-profile-step-2.PNG)  
    </td></tr></tbody></table>

---

### Step 2: Adding Your Email Account

Once you’ve named your profile, Outlook will ask you how you want to connect your email. You have two main paths: **Automatic** and **Manual**.

#### Option A: Automatic Setup (Recommended)

This is the fastest method if you have set the [Autodiscover DNS record](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/dns-configuration#bkmrk-5.-autodiscover-reco). Outlook will try to "autodiscover" your server settings for you.

1. Enter your **Name**, **Email Address**, and **Password**.
2. Click **Next**.
3. Outlook will cycle through its configuration steps. Once you see three green checkmarks, you're all set!  
      
    [![Windows - Mail (Outlook) - Add a new Profile - step 3 - auto setup.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-02/scaled-1680-/windows-mail-outlook-add-a-new-profile-step-3-auto-setup.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-02/windows-mail-outlook-add-a-new-profile-step-3-auto-setup.PNG)

#### Option B: Manual Setup (IMAP)

If the automatic setup fails, or if you have specific server requirements from your provider, use the Manual path.

1. Select **Manual setup or additional server types** and click **Next**.
2. Choose **POP or IMAP**.
3. **Enter your Server Information:**
    
    
    - **Account Type:** IMAP
    - **Incoming mail server:** (Provided by your host)
    - **Outgoing mail server (SMTP):** (Provided by your host)
4. **More Settings (Crucial Step):** \* Click the **More Settings** button.
    
    
    - Under the **Outgoing Server** tab, check the box: *"My outgoing server (SMTP) requires authentication."*
    - Under the **Advanced** tab, ensure you are using the correct port numbers (usually 993 for IMAP and 465 or 587 for SMTP) and select **SSL/TLS** for the encrypted connection.
5. Click **OK**, then **Next** to test the settings.

  
[![Windows - Mail (Outlook) - Add a new Profile - step 3 - manual setup - IMAP.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-02/scaled-1680-/windows-mail-outlook-add-a-new-profile-step-3-manual-setup-imap.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-02/windows-mail-outlook-add-a-new-profile-step-3-manual-setup-imap.PNG)

  
[![Windows - Mail (Outlook) - Add a new Profile - step 3 - manual setup - IMAP details and More Settings.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-02/windows-mail-outlook-add-a-new-profile-step-3-manual-setup-imap-details-and-more-settings.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-02/windows-mail-outlook-add-a-new-profile-step-3-manual-setup-imap-details-and-more-settings.PNG)

[![Windows - Mail (Outlook) - Add a new Profile - step 3 - manual setup - IMAP details and More Settings 2.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-02/windows-mail-outlook-add-a-new-profile-step-3-manual-setup-imap-details-and-more-settings-2.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-02/windows-mail-outlook-add-a-new-profile-step-3-manual-setup-imap-details-and-more-settings-2.PNG)

---

### Step 3: Launching Your New Profile

Now that the profile is created, you need to tell Outlook to use it.

1. Back in the **Mail** window (where you clicked "Show Profiles"), look at the bottom section.
2. Select **"Prompt for a profile to be used"** if you want to choose between your old and new profile every time you open Outlook.
3. Alternatively, select **"Always use this profile"** and choose your new one from the dropdown to make it the default.
4. Click **Apply** and open Outlook.

**Enjoy your clean, fresh inbox!**

# Setup Calendar and Contacts

# Sync Contacts and Calendars using CalDAV and CardDAV

### How to sync your calendar and contacts across all your devices.

With **CalDAV** and **CardDAV**, you can keep your schedule and address book perfectly in sync across smartphones, tablets, and desktop applications. These protocols allow you to use your favorite native apps (like the built-in calendar on iOS or Android) rather than being forced to use a specific web interface.

<p class="callout info">**Note:** Please ensure your email account is an Enhanced mailbox - which supports mobile synchronization features - before beginning.  
</p>

### **Step 1: Get Your Server URLs**

You will need a specific URL for your Calendar and another for your Contacts. You can find these directly in your webmail interface:

1. Log into your **Webmail**.
2. Click on your **Profile Picture/Icon** in the top corner.
3. Select **My Account**.
4. Navigate to the **Synchronization** tab on the left-hand menu.
5. Copy the unique links found under **CalDAV URL** and **CardDAV URL**.  
      
    [![Webmail - Synchronization tab available for Enhanced mailboxes only.png](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/webmail-synchronization-tab-available-for-enhanced-mailboxes-only.png)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/webmail-synchronization-tab-available-for-enhanced-mailboxes-only.png)

The URLs generally follow this format:

- **CalDAV:** `https://yourdomain--com.w.emailarray.com/caldav`
- **CardDAV:** `https://yourdomain--com.w.emailarray.com/carddav`

###  **Step 2: Add a New Account to Your Device**

The process is similar across most platforms (iOS, Android, macOS, or Thunderbird).

1. Open your device's **Settings** or your preferred **Calendar/Contact app**.
2. Find the option to **Add Account**.
3. Select **Other** or **Advanced Setup** (do not select Google, Outlook.com, or iCloud).
4. Choose **CalDAV** (for Calendars) or **CardDAV** (for Contacts).

###  **Step 3: Enter Connection Details**

When prompted for account details, use the **Manual** or **Advanced** setup option:

- **Username:** Your **full email address** (e.g., john@mydomain.com).
- **Password:** Your email account password.
- **Server URL:** Paste the specific URL you copied from your webmail in Step 1.
- **Description:** Give the account a name, such as "Work Calendar" or "My Contacts."

Click **Finish** or **Save** to complete the setup. Your device will now begin the initial synchronization.

# Outlook - CalDAV Synchronizer Setup

<p class="callout info">**Enhanced mailbox only.**   
Enhanced mailboxes allow you to sync calendars (CalDAV) and contacts (CardDAV) across multiple devices with applications that support the CardDAV/CalDAV protocols.</p>

In Outlook you can sync via CalDAV / CardDAV by installing the caldavsynchronizer - an Open Source plugin that you can install on your computer and use with your Outlook. This plugin supports Outlook 2007 to Outlook 2016 and is Free and Open-Source Software (FOSS), licensed under AGPL 3 and developed by [Alexander Nimmervoll](https://sourceforge.net/u/nimm/profile/) and [Gerhard Zehetbauer](https://sourceforge.net/u/nertsch/profile/). You can find the project on [Github](https://github.com/aluxnimm/outlookcaldavsynchronizer) and [SourceForge](https://sourceforge.net/projects/outlookcaldavsynchronizer/).

This is a step-by-step guide to installing and setting up the caldavsynchronizer plugin.

#### 1. Download the caldavsynchronizer

You can download the caldavsynchronizer plugin from the project's website: [https://caldavsynchronizer.org/](https://caldavsynchronizer.org/).

#### 2. Install the caldavsynchronizer

Extract the downloaded .zip file and start the installation. Once the installation is complete, you will see a new ribbon called "CalDav Synchronizer" in your Outlook.

[![caldavsynchronizer setup - 1.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/caldavsynchronizer-setup-1.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/caldavsynchronizer-setup-1.PNG)

[![caldavsynchronizer setup - 2.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/caldavsynchronizer-setup-2.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/caldavsynchronizer-setup-2.PNG)

[![caldavsynchronizer setup - 3.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/caldavsynchronizer-setup-3.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/caldavsynchronizer-setup-3.PNG)

[![caldavsynchronizer setup - 4.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/caldavsynchronizer-setup-4.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/caldavsynchronizer-setup-4.PNG)

#### 3. Get your CalDAV / CardDAV URLs

First, you need to obtain your CalDAV / CardDAV URLs. CalDAV is for Calendar synchronization, and CardDAV is for Contacts.

- Log into the Webmail using your full **e-mail address** and your **current e-mail password**
- Click on the **User** icon from the top right to activate the menu. Then click on **My account**

[![Webmail - how to access advanced settings for your email account.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/webmail-how-to-access-advanced-settings-for-your-email-account.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/webmail-how-to-access-advanced-settings-for-your-email-account.jpg)

- In the **Synchronization** tab, find the CalDAV / CardDAV URL. You will need to copy and use these URLs with the caldavsynchronizer.

[![caldavsynchronizer setup - 8.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/caldavsynchronizer-setup-8.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/caldavsynchronizer-setup-8.PNG)


#### 4. Set up the caldavsynchronizer

- Open **Outlook** on your computer.
- Go to the **CalDav Synchronizer** ribbon. Click on the **Synchronization Profiles** option.

[![caldavsynchronizer setup - 5.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/caldavsynchronizer-setup-5.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/caldavsynchronizer-setup-5.PNG)

- Click on the **Add** button (plus sign) to set up a new Calendar or Addressbook to sync. Select the profile type **Generic CalDAV/CardDAV**.

[![caldavsynchronizer setup - 6.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/caldavsynchronizer-setup-6.PNG) ](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/caldavsynchronizer-setup-6.PNG)[![caldavsynchronizer setup - 7.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/caldavsynchronizer-setup-7.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/caldavsynchronizer-setup-7.PNG)

- A new profile window will show. Fill in the following details: 
    - Name: give a name to this profile. For example, Calendar - personal, or Calendar - work.
    - Outlook folder: create a new folder in the **Calendar Items** or **Contact Items** category. You can also choose an existing Calendar or Contact folder.
    - Server Settings: these are your CalDAV / CardDAV details: 
        - **DAV URL**: if you're adding a **Calendar**, use the **CalDAV** URL obtained from the Webmail at step 3. This URL should be in the form of https://mydomain–com.w.emailarray.com/caldav - be sure to replace mydomain--com with your own domain name. If you're adding a **Contact** list, use the **CardDAV** URL.
        - **Username**: your full email address
        - **Password**: your email password
        - **Email address**: your full email address
        - Click on the **Test or discover settings** button. If you have multiple Calendars (or Contact lists) you can choose which one of them to sync with this Profile.
    - Sync Settings: choose how and how often to synchronize the Profile. **We recommend the Outlook ↔ Server (Two-Way) synchronization mode**.
    - After you finish the setup, you can choose to synchronize items immediately after change by ticking the option in the Outlook Settings. Please note you can only activate this option after you have finished the above setup and clicked on the Test or discover settings.
    - Click on the **OK** button to finish setup and save changes.

[![caldavsynchronizer setup - 9.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/caldavsynchronizer-setup-9.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/caldavsynchronizer-setup-9.PNG)

#### 5. Synchronize your new Profile

If the synchronization didn't start automatically, you could manually sync by going to the CalDAV Synchronization ribbon in Outlook and clicking the **Synchronize now** option.

[![caldavsynchronizer setup - 5.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/caldavsynchronizer-setup-5.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/caldavsynchronizer-setup-5.PNG)

<p class="callout info">You can now set up a new Calendar or Contact list by adding a new Profile (step 4).</p>

# Thunderbird - Syncing Contacts and Calendars

<span data-path-to-node="1,1"><span class="citation-785">Keep your schedule and address book in sync across all your devices using </span>**<span class="citation-785">CalDAV</span>**<span class="citation-785"> and </span>**<span class="citation-785">CardDAV</span>**<span class="citation-785"> protocols</span></span><span data-path-to-node="1,2"><span class="citation-785 citation-end-785"><sup class="superscript" data-turn-source-index="1"></sup><sup class="superscript" data-turn-source-index="1"></sup><sup class="superscript" data-turn-source-index="1"></sup><sup class="superscript" data-turn-source-index="1"></sup><sup class="superscript" data-turn-source-index="1"></sup><sup class="superscript" data-turn-source-index="1"></sup></span></span><span data-path-to-node="1,3">. </span><span data-path-to-node="1,5"><span class="citation-784">This allows you to manage your data directly within Thunderbird rather than using a web interface</span></span><span data-path-to-node="1,6"><span class="citation-784 citation-end-784"><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup><sup class="superscript" data-turn-source-index="2"></sup></span></span><span data-path-to-node="1,7">.  
</span>

<p class="callout info"><span data-path-to-node="1,7"><span data-path-to-node="2,1,0">**<span class="citation-783">Note:</span>**<span class="citation-783"> Please ensure your email account is an </span>**<span class="citation-783">Enhanced</span>**<span class="citation-783"> </span><span class="citation-783">mailbox, as these mailboxes support advanced synchronization features</span></span><span data-path-to-node="2,1,1"><span class="citation-783 citation-end-783"><sup class="superscript" data-turn-source-index="3"></sup><sup class="superscript" data-turn-source-index="3"></sup><sup class="superscript" data-turn-source-index="3"></sup><sup class="superscript" data-turn-source-index="3"></sup><sup class="superscript" data-turn-source-index="3"></sup><sup class="superscript" data-turn-source-index="3"></sup><sup class="superscript" data-turn-source-index="3"></sup><sup class="superscript" data-turn-source-index="3"></sup><sup class="superscript" data-turn-source-index="3"></sup></span></span><span data-path-to-node="2,1,2">.</span></span></p>

### Step 1: Get Your Server URLs

You will need a specific URL for your Calendar and another for your Contacts. You can find these in your webmail:

1. Log into your **Webmail**.
2. Click on your **Profile Picture/Icon** in the top corner.
3. Select **My Account**.  
      
    [![Webmail - how to access advanced settings for your email account.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/etxwebmail-how-to-access-advanced-settings-for-your-email-account.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/etxwebmail-how-to-access-advanced-settings-for-your-email-account.jpg)
4. Navigate to the **Synchronization** tab on the left-hand menu.
5. Copy the unique links found under **CalDAV URL** and **CardDAV URL**.  
      
    [![Webmail - Synchronization tab available for Enhanced mailboxes only.png](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/webmail-synchronization-tab-available-for-enhanced-mailboxes-only.png)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/webmail-synchronization-tab-available-for-enhanced-mailboxes-only.png)

**Example URL Formats:**

- **CalDAV:** `https://yourdomain--com.w.emailarray.com/caldav`
- **CardDAV:** `<a href="https://yourdomain--com.w.emailarray.com/carddav">https://yourdomain--com.w.emailarray.com/carddav</a>`

### Step 2: Set Up Your Calendar (CalDAV)

1. In Thunderbird, locate the **Connect your linked services** section and click **Connect to a remote calendar**.
2. In the "Create New Calendar" window, select **On the Network** and click **Next**.  
      
    [![Thunderbird - connect to a remote calendar.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/thunderbird-connect-to-a-remote-calendar.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/thunderbird-connect-to-a-remote-calendar.PNG)
3. **Enter Connection Details:**
    
    
    - **Username:** Your full email address.
    - **Location:** Paste your unique **CalDAV URL** from Step 1.
    - Click **Find Calendars**.  
          
        [![Thunderbird - connect to a remote calendar - step 1.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/thunderbird-connect-to-a-remote-calendar-step-1.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/thunderbird-connect-to-a-remote-calendar-step-1.PNG)
4. **Authentication:** A prompt will appear asking for your password. Enter your email password and check **Use Password Manager to remember this password**.  
      
    [![Thunderbird - connect to a remote calendar - step 2.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/thunderbird-connect-to-a-remote-calendar-step-2.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/thunderbird-connect-to-a-remote-calendar-step-2.PNG)
5. **Finalize:** Select the calendar(s) you wish to subscribe to and click **Subscribe**.  
      
    [![Thunderbird - connect to a remote calendar - step 3.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/thunderbird-connect-to-a-remote-calendar-step-3.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/thunderbird-connect-to-a-remote-calendar-step-3.PNG)

###  

### Step 3: Set Up Your Contacts (CardDAV)

1. In the **Connect your linked services** section, click **Connect to a CardDAV address book**.
2. **Enter Connection Details:**
    
    
    - **Username:** Your full email address.
    - **Location:** Paste your unique **CardDAV URL** from Step 1.
    - Click **Continue**.  
          
        [![Thunderbird - connect to a cardDAV address book - step 1.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/thunderbird-connect-to-a-carddav-address-book-step-1.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/thunderbird-connect-to-a-carddav-address-book-step-1.PNG)
3. **Authentication:** When the "Authentication Required" window appears, verify your username and enter your email password. Check the box to remember the password and click **OK**.  
      
    [![Thunderbird - connect to a cardDAV address book - step 2.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/thunderbird-connect-to-a-carddav-address-book-step-2.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/thunderbird-connect-to-a-carddav-address-book-step-2.PNG)
4. Your address book will now synchronize with Thunderbird.

#### Troubleshooting Tips

**Verify Your Plan**: Basic mailboxes support email synchronization only. If you cannot see the Synchronization tab in webmail, you may need to upgrade to an Enhanced plan.

**Check Your URL**: Ensure there are no extra spaces at the beginning or end of the URL when pasting it into Thunderbird.

**Direct Sync**: Unlike standard IMAP which only syncs email, these steps ensure your Calendar, Contacts, and Tasks stay updated across your computer, phone, and tablet.

# eM Client - Syncing Calendar and Contacts

<span data-path-to-node="1,0">eM Client is a powerful groupware tool that allows you to manage your professional life in one place. </span><span data-path-to-node="1,2"><span class="citation-850">By connecting your </span>**<span class="citation-850">Calendar (CalDAV)</span>**<span class="citation-850"> and </span>**<span class="citation-850">Contacts (CardDAV)</span>**<span class="citation-850">, you can keep your schedule and address book perfectly synchronized between eM Client and your other devices</span></span><span data-path-to-node="1,3"><span class="citation-850 citation-end-850"><sup class="superscript" data-turn-source-index="1"></sup><sup class="superscript" data-turn-source-index="1"></sup><sup class="superscript" data-turn-source-index="1"></sup><sup class="superscript" data-turn-source-index="1"></sup></span></span><span data-path-to-node="1,4">.</span>

<p class="callout info"><span data-path-to-node="1,4"><span data-path-to-node="2,1,0">**<span class="citation-783">Note:</span>**<span class="citation-783"> Please ensure your email account is an </span>**<span class="citation-783">Enhanced</span>**<span class="citation-783"> </span><span class="citation-783">mailbox, as these mailboxes support advanced synchronization features</span></span><span data-path-to-node="2,1,2">.</span></span></p>

### Step 1: Get Your Server URLs

You will need a specific URL for your Calendar and another for your Contacts. You can find these in your webmail:

1. Log into your **Webmail**.
2. Click on your **Profile Picture/Icon** in the top corner.
3. Select **My Account**.  
      
    [![Webmail - how to access advanced settings for your email account.jpg](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/scaled-1680-/etxwebmail-how-to-access-advanced-settings-for-your-email-account.jpg)](https://wikidev.emailarray.com/uploads/images/gallery/2024-08/etxwebmail-how-to-access-advanced-settings-for-your-email-account.jpg)
4. Navigate to the **Synchronization** tab on the left-hand menu.
5. Copy the unique links found under **CalDAV URL** and **CardDAV URL**.  
      
    [![Webmail - Synchronization tab available for Enhanced mailboxes only.png](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/webmail-synchronization-tab-available-for-enhanced-mailboxes-only.png)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/webmail-synchronization-tab-available-for-enhanced-mailboxes-only.png)

**Example URL Formats:**

- **CalDAV:** `https://yourdomain--com.w.emailarray.com/caldav`
- **CardDAV:** `<a href="https://yourdomain--com.w.emailarray.com/carddav">https://yourdomain--com.w.emailarray.com/carddav</a>`

## Step 2: Set Up Your Calendar (CalDAV)

1. Open eM Client and go to **Menu &gt; Accounts &gt; Add Account**.
2. Select the **Calendar** tab and choose **CalDAV**. Click **Next**.  
    [![eM Client - calendar - step 1.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-calendar-step-1.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-calendar-step-1.PNG)
3. **Enter Server Information:**
    
    
    - **Account address:** Paste your unique **CalDAV URL**.
    - **User name:** Your full email address.
    - **Password:** Your email account password.
    - Click **Next**.  
          
        [![eM Client - calendar - step 2.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-calendar-step-2.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-calendar-step-2.PNG)
4. **Account Details:** Enter an **Account name** (e.g., "Work Calendar") so you can easily identify it in your list. Click **Next**.  
      
    [![eM Client - calendar - step 3.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-calendar-step-3.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-calendar-step-3.PNG)
5. **Finalize:** Click **Finish** to complete the setup. Your events will now begin to sync.  
      
    [![eM Client - calendar - step 4.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-calendar-step-4.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-calendar-step-4.PNG)

---

## Step 3: Set Up Your Contacts (CardDAV)

1. Go to **Menu &gt; Accounts &gt; Add Account**.
2. Select the **Contacts** tab and choose **CardDAV**. Click **Next**.  
      
    [![eM Client - contacts - add cardDAV account.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-contacts-add-carddav-account.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-contacts-add-carddav-account.PNG)
3. **Enter Server Information:**
    
    
    - **Account address:** Paste your unique **CardDAV URL**.
    - **User name:** Your full email address.
    - **Password:** Your email account password.
    - Click **Next**.  
          
        [![eM Client - contacts - step 1.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-contacts-step-1.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-contacts-step-1.PNG)
4. **Account Details:** Enter an **Account name** (e.g., "Company Contacts") and click **Next**.  
      
    [![eM Client - contacts - step 2.PNG](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/scaled-1680-/em-client-contacts-step-2.PNG)](https://wikidev.emailarray.com/uploads/images/gallery/2026-01/em-client-contacts-step-2.PNG)
5. **Finalize:** Click **Finish**. Your address book is now connected.

---

### Troubleshooting &amp; Tips

- <span data-path-to-node="15,0,1,0">**<span class="citation-846">Authentication Errors:</span>**<span class="citation-846"> Ensure you are using your </span>**<span class="citation-846">full email address</span>**<span class="citation-846"> as the username</span></span><span data-path-to-node="15,0,1,1"><span class="citation-846 citation-end-846"><sup class="superscript" data-turn-source-index="5"></sup></span></span><span data-path-to-node="15,0,1,2">.</span>
- <span data-path-to-node="15,0,1,2"><span data-path-to-node="15,1,1,0">**<span class="citation-845">Connection Security:</span>**<span class="citation-845"> eM Client automatically uses secure connections for these protocols</span></span><span data-path-to-node="15,1,1,1"><span class="citation-845 citation-end-845"><sup class="superscript" data-turn-source-index="6"></sup></span></span><span data-path-to-node="15,1,1,2">.</span></span>
- <span data-path-to-node="15,0,1,2"><span data-path-to-node="15,1,1,2"><span data-path-to-node="15,2,1,0">**<span class="citation-844">Dynamic Storage:</span>**<span class="citation-844"> Remember that your combined storage (including calendar attachments and contacts) is shared across your mailbox</span></span><span data-path-to-node="15,2,1,1"><span class="citation-844 citation-end-844"><sup class="superscript" data-turn-source-index="7"></sup></span></span><span data-path-to-node="15,2,1,2">.</span></span></span>

# ActiveSync / EAS - Syncing Calendars and Contacts

### Sync your email, calendar, and contacts in real-time.

**ActiveSync** is the most powerful way to connect your mailbox to your mobile devices and desktop apps. Unlike standard email setups, ActiveSync provides a real-time "push" connection that synchronizes your **email**, **calendar**, **contacts**, and **notes** instantly across all your devices. This ensures your data is always consistent, no matter where you are:

- **Effortless Management**: When you delete an email on your phone, it’s instantly removed from your computer, and when you add a meeting to your calendar, it appears everywhere.
- **Contacts on the Go**: If you save a new client's phone number on your smartphone while out of the office, that contact will be waiting for you in your webmail address book the moment you sit down at your desk.
- **Real-time Updates**: If you update a contact’s email address or job title in your desktop email app, your phone's native contacts list will reflect that change automatically without you having to lift a finger.

#### <span style="background-color: rgb(53, 152, 219); color: rgb(255, 255, 255);">[**Click Here to see the ActiveSync setup**](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/activesync-eas-sync-email-calendars-and-contacts)</span>

# Cheat Sheet with all the details

# Quick Setup Guide

## Step 1: Add a new domain

1. Log into Admin Panel ([admin.emailarray.com](http://admin.emailarray.com)) with signup credentials
2. **Domains** → **New** → Enter domain (format: `mydomain.com` - no http/www)
3. Click on the red checkmark to get a **TXT record value** for domain verification (shown in popup)

---

## Step 2: Add the Required DNS Records

This configuration must be done at the domain's registrar or DNS hosting provider (e.g., Cloudflare, Namecheap, GoDaddy):

#### ✅ TXT (Domain Verification)

> Verifies your domain with us. Get the TXT details from Step 1 and add it to your DNS:

<table id="bkmrk-type-name%2Fhost-value"><thead><tr><th>Type</th><th>Name/Host</th><th>Value</th><th>TTL</th></tr></thead><tbody><tr><td>TXT</td><td>mx-verification</td><td>Provided verification token</td><td>3600</td></tr></tbody></table>

---

#### ✅ MX (Mail Exchange)

> Directs incoming email to us. You can wait to make this change **after we complete the email migration**.

> Remove existing MX records first

<table id="bkmrk-type-name-%2F-host-val"><thead><tr><th>Type</th><th>Name / Host</th><th>Value</th><th>Priority</th><th>TTL</th></tr></thead><tbody><tr><td>MX</td><td>@ or [yourdomain.com](http://yourdomain.com)</td><td>[mx.emailarray.com](http://mx.emailarray.com)</td><td>5</td><td>3600</td></tr><tr><td>MX</td><td>@ or [yourdomain.com](http://yourdomain.com)</td><td>[mx2.emailarray.com](http://mx2.emailarray.com)</td><td>10</td><td>3600</td></tr></tbody></table>

---

#### ✅ SPF (Sender Policy Framework)

> Authorizes us to send emails on your domain's behalf and prevents bad actors to send emails on your behalf.
> 
> If there's an existing SPF record: Add `include:emailarray.com` before `-all`

<table id="bkmrk-type-name-value-ttl-"><thead><tr><th>Type</th><th>Name</th><th>Value</th><th>TTL</th></tr></thead><tbody><tr><td>TXT</td><td>@ or [yourdomain.com](http://yourdomain.com)</td><td>v=spf1 include:emailarray.com ~all</td><td>3600</td></tr></tbody></table>

---

#### ✅ Webmail Access (Optional but Recommended)

<table id="bkmrk-type-name-value-ttl--1"><thead><tr><th>Type</th><th>Name</th><th>Value</th><th>TTL</th></tr></thead><tbody><tr><td>CNAME</td><td>webmail</td><td>[webredirect.emailarray.com](http://webredirect.emailarray.com)</td><td>3600</td></tr></tbody></table>

> Lets users access Webmail via `webmail.yourdomain.com`

---

#### ✅ DKIM (DomainKeys Identified Mail)

<table id="bkmrk-type-name-%28host%29-val" style="width: 68.6905%; height: 59.2px;"><thead><tr style="height: 29.6px;"><th style="width: 8.8147%; height: 29.6px;">Type</th><th style="width: 38.4471%; height: 29.6px;">Name (Host)</th><th style="width: 44.0735%; height: 29.6px;">Value (TXT)</th><th style="width: 8.8147%; height: 29.6px;">TTL</th></tr></thead><tbody><tr style="height: 29.6px;"><td style="width: 8.8147%; height: 29.6px;">TXT</td><td style="width: 38.4471%; height: 29.6px;">Provided **Host** by Admin Panel</td><td style="width: 44.0735%; height: 29.6px;">Provided **Key** by Admin Panel</td><td style="width: 8.8147%; height: 29.6px;">3600</td></tr></tbody></table>

> Improves email deliverability by authenticating the sender. DKIM helps protect against email spoofing and phishing attacks.

**How to Enable DKIM**:

1. Go to the **Admin Panel** and log in
2. Click **Domains**
3. Click the **DKIM icon** next to your domain
4. In the popup window, switch **Enable** to **Yes**
5. Copy the **Host** and **Key** values
6. Add a **TXT record** in your DNS using: 
    - **Host** as the name
    - **Key** as the TXT value
7. Wait for DNS propagation

---

#### ✅ Autodiscover &amp; Autoconfig (Optional but Recommended)

<table id="bkmrk-type-name-value-ttl--2"><thead><tr><th>Type</th><th>Name</th><th>Value</th><th>TTL</th></tr></thead><tbody><tr><td>A</td><td>autodiscover.***yourdomain.com***</td><td>69.28.212.195</td><td>3600</td></tr><tr><td>A</td><td>autoconfig.***yourdomain.com***</td><td>69.28.212.195</td><td>3600</td></tr></tbody></table>

> Don't forget to replace **[yourdomain.com](http://yourdomain.com)** with your own domain name

> Enables automatic configuration for email clients such as Outlook, Thunderbird, eM Client, etc.

---

## Step 3: Verification

1. Log into Admin Panel ([admin.emailarray.com](http://admin.emailarray.com)) with signup credentials and go to the **Domains** tab.
2. Click on the **Health** button to check your domain health. Wait 5-60 minutes for DNS propagation. SSL records might take an additional 30 minutes to update.
3. Click **Verify again**. When all records show green your domain is completely configured.

---

## Step 4: Create Email Account

1. Log into Admin Panel ([admin.emailarray.com](http://admin.emailarray.com)) with signup credentials
2. **Users** → Select domain → **New**
3. Configure: 
    - Account Type: Basic/Enhanced/OEX
    - Username: desired prefix (letters, numbers, dots only)
    - Password: 8+ chars (upper, lower, number, symbol)
    - Quota: 0.1-50 GB (Basic) / 0.1-200 GB (Enhanced)
    - Other optional settings: Language, Timezone or Localization and Date format.

---

## Step 5: Access Webmail

- **Option 1:** `webmail.yourdomain.com` (if CNAME configured)
- **Option 2:** Click envelope icon in Admin Panel Users page and bookmark the generated URL (such as httsp://yourdomain--com.w.emailarray.com)
- **Option3:** Go to `https://login.emailarray.com/` and login.

---


## Additional Setup - Email Client Configuration

### IMAP (Recommended)

- **Incoming Server:** `imap.emailarray.com`
- **SSL:** Port 993
- **Authentication:** Required

### SMTP (Outgoing)

- **Server:** `smtp.emailarray.com`
- **SSL:** Port 465
- **Authentication:** Required

### ActiveSync (**Enhanced** accounts only)

- For Enhanced mailboxes, you can add the new account as ActiveSync / Exchange in your email app. Syncs email, calendar, contacts across mobile devices.

### Sync Calendar and Contacts with CalDAV and CardDAV (**Enhanced** accounts only)

The URLs generally follow this format, please make sure you replace *yourdomain--com* with your own domain name ([full setup here](https://wikidev.emailarray.com/books/1-configure-a-new-e-mail-address-getting-started/page/sync-contacts-and-calendars-using-caldav-and-carddav)):

- **CalDAV:** `https://yourdomain--com.w.emailarray.com/caldav`
- **CardDAV:** `https://yourdomain--com.w.emailarray.com/carddav`

---


## Troubleshooting

- DNS changes can take up to 24 hours to propagate
- Red "Fail" status is normal until DNS propagates
- Use domain health popup for detailed record status
- **No incoming emails:** Check MX records using [mxtoolbox.com](http://mxtoolbox.com)
- **Emails going to Spam:** Ensure SPF and DKIM records are properly configured with the domain's DNS provider (check with [mxtoolbox.com](http://mxtoolbox.com)). Add DMARC records to DNS provider.