# Cheat Sheet with all the details for WHMCS

<span style="color: rgb(34, 34, 34); font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Oxygen, Ubuntu, Roboto, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 2.8275em; font-weight: 400;">Step 1: Add a new domain</span>

1. Place a new order from your WHMCS. You are required to **enter your domain**.
2. After placing the order, you will be redirected to your Client Area. An alert will be shown until you verify the domain by adding a TXT record to your DNS (see next step).

---

## Step 2: Add the Required DNS Records

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

#### ✅ 1. TXT (Domain Verification)

Get the TXT verification details from WHMCS Client Area 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>

<p class="callout info">Verifies your domain with us</p>

<p class="callout warning">This domain verification DNS record is required before you can create the email addresses or manage the product.  
The other DNS records can be added / updated after the email migration.</p>

---

#### ✅ 2. MX (Mail Exchange)

<p class="callout info">Directs incoming email to us. You can wait to make this change **after we complete the email migration**.</p>

<p class="callout warning">Remove existing MX records first</p>

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

---

#### ✅ 3. SPF (Sender Policy Framework)

<p class="callout info">Authorizes us to send emails on your domain's behalf and prevents bad actors from sending emails on your behalf. </p>

<p class="callout warning">If there's an existing SPF record: Add `include:emailarray.com` before `-all`</p>

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

---

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

<p class="callout info">Lets users access Webmail via `webmail.yourdomain.com`</p>

---

#### ✅ 5. DKIM (DomainKeys Identified Mail)

**How to Enable DKIM**:

1. Go to your WHMCS Client Area -&gt; Click on the email hosting product -&gt; Click on **DKIM**.
2. Click on **Enable**.
3. Add the generated **Host** and **Key** from WHMCS to your DNS as a TXT record:

<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 WHMCS</td><td>Provided **Key** by WHMCS</td><td>3600</td></tr></tbody></table>

<p class="callout info">Improves email deliverability by authenticating the sender.   
DKIM helps protect against email spoofing and phishing attacks.</p>

---

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

<p class="callout warning">Don't forget to replace **[yourdomain.com](http://yourdomain.com)** with your own domain name</p>

<p class="callout info">Enables automatic configuration for email clients, such as Outlook, Thunderbird, eM Client, etc.</p>

---

## Step 3: Create Email Account

1. Go to your WHMCS Client Area -&gt; Click on the email hosting product -&gt; Click on **Accounts**.
2. Click the **Add Mailbox** button.
3. Fill in the new user’s details (username, password, quota, etc.).
4. Click **Save**.

---

## Step 4: Access Webmail

- **Option 1:** `webmail.yourdomain.com` (if Webmail CNAME is configured in your DNS) and login with your full email address and password. You can bookmark the URL.
- **Option 2:**
    - Go to your WHMCS Client Area -&gt; Click on the email hosting product -&gt; Click on **Accounts**.
    - In the mailboxes list, click the **Webmail** button next to the desired account. This opens a new tab and logs you in automatically.
    - You can now bookmark the URL and use it to log in with your email address and password.
- **Option 3:** Go to `https://login.emailarray.com/` and login with your full email address and password.

---


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