Domains

A file in domains/ is one Domain: its role, what it hosts, its redirects and email at the domain. It implements the domains of the site product.

ReferenceCopy Anchor Link

The file name is the hostname, and the file is frontmatter only. Buying and connecting are Verbs, Domain.register and Domain.connect, never files.

Registrar status and certificate state are observed and never written.

ExamplesCopy Anchor Link

MinimalCopy Anchor Link

---
role: primary
hosts: sites/www
---

LeaselineCopy Anchor Link

---
role: primary
hosts: sites/www
redirects: { www.leaseline.com: leaseline.com }
email: { mailboxes: [hello, support] }
---

What it buildsCopy Anchor Link

The SiteBuilder compiles the file.

• the Domain record, connected with Domain.connect or bought with Domain.register
• DNS records for the Site, the App and mail, set with DNSRecord.set
• a certificate, renewed before it expires
• a Mailbox per address, authenticated with Domain.authenticate
• the Events Domain.connected and Domain.authenticated

RoutingCopy Anchor Link

The hosts path serves at the root of the hostname. The API serves at /api and the App at /app on the primary Domain.

Good to knowCopy Anchor Link

• The founder's form of this file is the guide connect my domain.