Adding a Domain to TrekMail

Adding your domain is your first real milestone in TrekMail. Once your DNS is in place, you can start receiving mail right away and unlock sending options based on your plan.

Who this is for

• Anyone setting up a new email domain.
• Users migrating from another provider (Gmail, cPanel, Zoho).

What you’ll achieve

• Connect your domain (yourcompany.com) to TrekMail.
• Configure DNS records to prove ownership and secure your email.
• Achieve an Active status to start creating mailboxes.

Adding a Single Domain

1. Register the domain

1. Go to Domains -> Add domain.
2. Enter your root domain name (e.g., example.com).
3. Click Add Domain. You will be taken to the domain overview.
4. The initial status will be Pending DNS until we verify your records.

Tip: First time adding a domain? Use the "Guide" button on the Domains Page to take an interactive tour of the interface, including where to find your verification status and catch-all settings.

Adding Multiple Domains (Bulk Import)

If you need to add several domains at once, use the Bulk Import feature:

1. Go to Domains -> Add domain.
2. Click Bulk to switch to bulk import mode.
3. Follow the 3-step wizard:
   • Step 1: Input — Paste domain names (one per line or comma-separated) or drag-and-drop a .txt file.
   • Step 2: Validate — Review the validation results. Fix any format issues or duplicates.
   • Step 3: Setup — Create your domains and copy the DNS records for each.

For detailed instructions, see Bulk Importing Domains.

2. Add Required DNS Records

Switch to the DNS & Health tab. You will see a list of records we expect to find.

Option A: One-Click Setup via Cloudflare (Recommended)

If your domain uses Cloudflare DNS, click Set up DNS automatically on the domain's DNS & Health tab. You'll be redirected to Cloudflare, where you can review and approve all DNS records in one click — no API token needed.

Option B: Bulk Setup via Cloudflare API Token

If you have many domains on Cloudflare and want to set them all up at once:

1. Go to Domains, click the Cloudflare tab in the "Add a domain" card (or go directly to /app/domains?add=cloudflare).
2. Follow the 3-step wizard: create an API token on Cloudflare, review your domains (all selected automatically), and apply.
3. New domains are added to TrekMail and all DNS records (required and recommended, including MTA-STS) are created automatically with the correct settings. Existing conflicting records are replaced automatically.

You can add and configure DNS for multiple Cloudflare domains at once. See Cloudflare Automatic DNS Setup for the full guide.

Option C: Manual DNS Setup

You can also export all DNS records as a CSV file from the Export → Export DNS records button on the Domains page. This is useful when configuring multiple domains at once — the CSV is compatible with bulk import tools at most registrars.

Copy the records below into your DNS provider (Cloudflare, GoDaddy, Namecheap, etc.).

Note: If you already have an SPF record (e.g., for Google Workspace), do not create a new one. Instead, edit your existing record to include include:spf.trekmail.net before the -all or ~all.

Important: The autodiscover and autoconfig CNAMEs must be DNS-only (grey-cloud in Cloudflare). With proxy enabled (orange-cloud), automatic Outlook setup will fail — Cloudflare intercepts the SSL handshake and our cert can't be installed. The Cloudflare auto-setup option above creates these records correctly by default.

3. Verify connection

1. After saving the records in your DNS provider, wait 1-5 minutes.
2. Click Verify DNS in TrekMail.
3. The system will check each record live.
   • ✅ Green Check: The record is correct.
   • ⚠️ Yellow Warning: A conflict exists or an optional record is missing.
   • ❌ Red Error: The record is missing or incorrect.
4. When all Required records are green, your domain status will change to Active.

Common mistakes & quick fixes

• Symptom: Domain stays "Pending DNS" for hours.
  • Likely Cause: Legacy MX records still exist.
  • Fix: Remove old MX records (like ASPPMX.L.GOOGLE.COM), keep only TrekMail MX values, then click Verify DNS again.
• Symptom: "SPF Conflict" warning.
  • Likely Cause: You added two separate TXT records for SPF.
  • Fix: Merge them into a single line. Example: v=spf1 include:_spf.google.com include:spf.trekmail.net -all.
• Symptom: DKIM record is missing a value.
  • Likely Cause: The key wasn't generated yet.
  • Fix: Click Verify DNS once to trigger the key generation, then refresh the page.