cmail

Custom-domain email · v0.4.0

Your domain.
Your everyday inbox.

Get hello@your-domain delivered to the inbox you already use: Gmail, Outlook, iCloud, Proton or any other. A few simple steps and one command set it up. You only pay for the domain.

Start the setup guideRead the docs

macOS or Linux · any domain registrar · free Cloudflare account

How mail flows A sender writes to hello@your-domain. Cloudflare Email Routing receives it and forwards it to your existing inbox. Someone emails youfrom any mail provider hello@your-domainyour custom address Cloudflare Email Routingforwards it, free Your existing inboxGmail, Outlook, iCloud, Proton…
No new mailbox. Mail keeps landing where you already read it.

Four steps from domain to inbox.

  1. 1

    Install

    Run one curl command (or brew install). One binary, no clone, no sudo.

  2. 2

    Create a token

    One scoped Cloudflare API token. Setup opens the page for you.

  3. 3

    Run cmail setup

    Answer two questions. cmail creates the zone, routing and rules.

  4. 4

    Test

    Email your new address from another mailbox and watch it arrive.

DNS propagation can add waiting time. cmail waits for you and can be rerun at any point; finished steps are skipped.

Follow the step-by-step guide

What you see at the end.

── Forwarding addresses (hello,contact -> [email protected]) ──
 ✓ [email protected] -> [email protected]
 ✓ [email protected] -> [email protected]

Receiving is set up
  [email protected] -> [email protected]
  [email protected] -> [email protected]

Elapsed time: 6m 41s (401 seconds)
  • Any registrar. Keep your domain where it is.
  • Any inbox. No Google account needed to receive.
  • Safe to rerun. Existing zones, destinations and rules are reused, never overwritten.
  • Preview first. cmail setup --dry-run changes nothing.

Illustrative output. Your addresses and time will differ.

Quick answers.

Does cmail give me a new mailbox?

No. Cloudflare forwards incoming mail to an inbox you already own. That inbox stores the messages.

Can I send from my custom address?

Sending is optional. cmail send-as walks you through Gmail “Send mail as”. Google has announced it will remove third-party “Send as” starting January 2027, so check Google’s help page before relying on it.

What does it cost?

You pay for the domain. Cloudflare Email Routing is free; provider plans and limits still apply.

Will it break my website or existing email?

Only if you skip a step. Before switching nameservers, copy your existing DNS records into Cloudflare. The guide shows exactly when.

Does cmail collect any data?

No. It talks only to Cloudflare (and GoDaddy if you opt in) with your own token. See Privacy.