Docs / Guides / Email forwarding

Email forwarding

you@you.runs-on.dev arriving in your real inbox, via MX records and ImprovMX.

The record

domains/you.json

"records": {
  "MX": [
    { "priority": 10, "value": "mx1.improvmx.com" },
    { "priority": 20, "value": "mx2.improvmx.com" }
  ]
}

mx1.improvmx.com and mx2.improvmx.com at priorities 10 and 20 are ImprovMX's standard mail servers, the same for every domain. MX may coexist with A and TXT at the same name, so this is safe to add even if you also point you.runs-on.dev at a site.

Steps

  1. At improvmx.com, add you.runs-on.dev as a domain and set up a forwarding alias (for example, *@you.runs-on.dev → your real address).
  2. Fork the registry and edit domains/you.json to the record above.
  3. Open a pull request. Once merged, the MX records are synced to DNS automatically.

How to tell it worked

ImprovMX's dashboard shows the domain as verified once it can see both MX records. Send a test email to your you.runs-on.dev address and confirm it lands in the forwarded inbox, usually within a minute.