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

Automatic setup, when it is offered

For an eligible Cloudflare-managed domain, TrekMail can offer a Domain Connect button in DNS & Health. This route does not need an API token, but it is not shown for every domain configuration. If the button is not present, use the API-token or manual route below.

1. Open your domain's DNS & Health tab in TrekMail.
2. Click Set up DNS automatically.
3. Review and approve the records on Cloudflare's consent screen.
4. Return to TrekMail and wait for the DNS check to confirm the records. A successful return from Cloudflare is not the same as a completed DNS verification.

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 with Zone → DNS → Edit for the zones you want TrekMail to manage. Use the smallest zone scope that suits the batch.
   • Step 2: Review the detected zones and select only the domains you want to connect.
   • Step 3: Review and apply DNS records.

The wizard can add new domains to TrekMail and prepares a per-domain preview. Review every proposed change, particularly SPF merges and conflicts. Apply only the records you intend to manage; the wizard writes the selected records after your confirmation.

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. For MX and TXT records, use the values shown in TrekMail's DNS screen. Those record types are not Cloudflare-proxied. If TrekMail asks you to create a mail-related CNAME, leave it DNS only (grey cloud), not proxied.

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.

These controls are available only when Namecheap is the authoritative DNS provider for the domain. If the domain uses custom nameservers, add the records at that DNS provider instead.

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 the provider default unless TrekMail gives you a specific value.

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 a mail CNAME: MX and TXT records cannot be proxied by Cloudflare. If you add a CNAME used for mail, keep it DNS only (grey cloud).
• 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.
• Editing the wrong DNS provider: The registrar where you bought a domain may not be the provider that answers DNS for it. Check the domain's nameservers before you edit anything.

Provider references

Provider screens change. These official guides show the current entry points: Cloudflare DNS records, Namecheap host records, and Amazon Route 53 records.