MastriaDocs

Custom domains

Your academy starts at yourname.mastria.dev and works there indefinitely. When you want it on your own domain — learn.yourcompany.com or academy.yourcompany.com — it's one DNS record on your side.

What you need

  • A subdomain of a domain you control: learn.yourcompany.com, academy.yourcompany.com, training.yourcompany.com — your pick. (Bare apex domains like yourcompany.com can't point at an academy; you want your homepage there anyway.)
  • Access to your DNS provider to add one record.

Setup

  1. Tell us the domain you want to use. We register it for your academy and with our hosting.

  2. Add one CNAME record at your DNS provider:

    learn.yourcompany.com    CNAME    cname.vercel-dns.com

  3. We verify and switch it on. Verification confirms the DNS is actually pointing where it should — a domain never serves an academy until it's verified, so nobody can claim a hostname they don't control.

HTTPS is automatic: a TLS certificate is issued for your domain within minutes of the DNS change, and renews itself. There is nothing to buy, upload, or rotate.

What changes for learners

Everything simply lives on your domain: course URLs, sign-in links, magic link emails — a learner who signs in on learn.yourcompany.com stays on learn.yourcompany.com the whole way through. Your yourname.mastria.dev subdomain keeps working alongside it.

Timing

DNS changes usually propagate in minutes, occasionally up to an hour. The whole process — from telling us the domain to a live, HTTPS-served academy — typically fits inside a coffee break.