← CLI Reference

domain

Register custom domains for your VMs

Usage

domain <add|rm|ls> ...

Options

  • --json: output in JSON format

Examples

domain add my-vm app.example.com  # register a CNAME you've already set up
domain add --wildcard my-vm app.example.com  # also issue a *.example.com cert
domain ls my-vm                   # list domains on one VM
domain ls -a                      # list domains across all your VMs
domain rm my-vm app.example.com   # remove a domain

Subcommands

domain add

Link a custom domain to a VM

Usage:

domain add [--wildcard] <vm> <domain>

Options:

  • --json: output in JSON format
  • --wildcard: issue a wildcard (*.) certificate via DNS-01 delegation

domain rm

Remove a custom domain from a VM

Usage:

domain rm <vm> <domain>

Options:

  • --json: output in JSON format

domain ls

List custom domains for a VM (or -a for all your VMs)

Usage:

domain ls <vm> | domain ls -a

Options:

  • -a: list domains across all your VMs
  • --json: output in JSON format