DNS Setup with Popular Providers

Every DNS provider has a slightly different interface. Here are quick tips for the most common providers when adding TrekMail records.

Cloudflare

Recommended: One-Click Setup

The fastest method — no API token needed:

1. Open your domain's DNS & Health tab in TrekMail.
2. Click Set up DNS automatically.
3. Approve the records on Cloudflare's consent screen.
4. Done — all records are created instantly.

Alternative: Bulk Setup via API Token

To set up many Cloudflare domains at once:

1. Go to Domains and click the Cloudflare tab in the "Add a domain" card (or go directly to /app/domains?add=cloudflare).
2. Follow the 3-step wizard:
   • Step 1: Create a Cloudflare API token — Permissions: Zone → DNS → Edit, Zone Resources: All zones.
   • Step 2: Review your domains (all selected automatically).
   • Step 3: Review and apply DNS records.

The wizard adds new domains to TrekMail and creates all required records (MX, SPF, DKIM, DMARC) plus recommended records (TLSRPT, MTA-STS) with the correct settings, including disabling the proxy for mail records.

For a detailed walkthrough, see Cloudflare Automatic DNS Setup.

Manual Setup

If you prefer to add records manually:

1. Go to DNS -> Records.
2. Add MX and TXT records.
3. Important: Turn Proxy Status (Orange Cloud) to OFF (Grey Cloud) for all mail-related records (MX, SPF, DKIM, DMARC).
   • Why? Cloudflare's proxy is for HTTP/Web traffic. It breaks email protocols if enabled on mail records.

Namecheap

1. Go to Domain List -> Manage -> Advanced DNS.
2. Under Mail Settings, select Custom MX.
3. Add the TrekMail MX record.
4. Add TXT records in the Host Records section.
   • Note: For the root domain, Namecheap uses @ as the Host.

GoDaddy

1. Go to DNS Management.
2. Click Add.
3. Type: Choose MX or TXT.
4. Name: Enter @ for the root domain, or the specific subdomain (e.g., _dmarc).
   • Note: GoDaddy automatically appends your domain name. Do not type _dmarc.example.com. Just type _dmarc.
5. TTL: Leave as default (1 Hour).

AWS Route53

1. Go to Hosted Zones and select your domain.
2. Click Create record.
3. Record Name: Leave blank for root (@) records.
4. Value: Paste the value.
   • DKIM Note: Route53 handles long keys automatically, but if you paste via the API, ensure you handle line breaks correctly. In the console, just paste the full string.

Common mistakes

• Proxying Mail Records: Never use Cloudflare's orange cloud for MX or DKIM. (TrekMail's auto-add feature handles this automatically.)
• Double Domain Names: If you type _dmarc.example.com into a field that expects just _dmarc, you end up with _dmarc.example.com.example.com. Use a global DNS checker to verify if this happened.