Docs / Guides / Netlify

Netlify

you.runs-on.dev serving a Netlify site, over HTTPS, via CNAME.

The record

domains/you.json

"records": { "CNAME": "apex-loadbalancer.netlify.com" }

apex-loadbalancer.netlify.com is Netlify's standard target for a custom subdomain, the same for every site.

Steps

  1. Fork the registry and edit domains/you.json to the record above.
  2. Open a pull request. Once merged, the CNAME is synced to DNS automatically.
  3. In the Netlify dashboard: your site → Domain management → Add a domain → you.runs-on.dev. Netlify needs the domain added here to issue a certificate for it, even though the DNS record itself lives in the registry, not in Netlify DNS.

How to tell it worked

Domain management shows the certificate status for you.runs-on.dev. Once it reads issued, https://you.runs-on.dev should serve your site.