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