tori domains

connect your own hostname to an app

Usage

npx tori.host domains list [app]

Your own hostname on an app. add prints the DNS record to create: a CNAME to the app's own name for a subdomain (www.example.com), or an A record to the zone's addresses for a two-label name (example.com). The control plane checks the record on a schedule and, once it points here, the zone obtains a certificate. Nothing is issued before the record resolves. check re-runs the DNS check now, at most once per 30 s.

[app] is the app's slug. When it is left out, the app is read from ./tori.json. --json prints the API's answer instead of the lines.

Options

• --json — print the API's answer instead of the lines
• --no-browser — sign in with a code you type on another device (chosen automatically over SSH or with no DISPLAY)

Subcommands

• tori domains list [app] — list the app's custom domains and their state
• tori domains add [app] <hostname> — connect a hostname; prints the DNS record to create
• tori domains remove [app] <hostname|id> — withdraw a hostname
• tori domains check [app] <hostname|id> — re-run the DNS check now

Examples

Connect a subdomain

npx tori.host domains add my-app www.example.com

Re-run the DNS check after fixing the record

npx tori.host domains check my-app www.example.com

Read the state as JSON

npx tori.host domains list my-app --json

This reference matches tori.host@0.9.7.

Download this page as Markdown.