lizard domain

Show or list a service’s domains, or attach a custom one.

Usage

lizard domain [hostname] [flags]

The hostname is a positional argument — there is no add subcommand. Running lizard domain with no arguments shows the service’s current domain, or generates one if it has none. Alias: lizard domains.

Flags

FlagDescription
-s, --service <name>Service
-p, --project <id>Project name, slug, or ID
--port <n>Ignored: a domain always routes to the service’s container port. Change that port with lizard port
-f, --forceMove the domain here if it’s attached to another of your services

The subcommands use the same -s and -p flags. Verify and delete a domain on the service you attached it to.

Subcommands

lizard domain generate

Give the service a *.onlizard.com subdomain. If it already has one, generate returns it. It fails while the service uses a custom domain; remove that first.

lizard domain list

List the service’s domains, and custom domains still waiting for DNS verification with the records to create (alias ls).

lizard domain verify <hostname>

Check the TXT record and activate the domain. TLS is provisioned automatically.

lizard domain delete <hostname>

Remove a domain (alias rm).

FlagDescription
-y, --yesSkip confirmation

Examples

Show the current domain

lizard domain

Generate a subdomain

lizard domain generate

Attach a custom domain

lizard domain app.example.com --service web

Lizard returns the DNS records to create: a CNAME for the hostname and, unless you already verified the domain, a TXT record at _lizard-verify.<apex domain> (for app.example.com, that is _lizard-verify.example.com). Add them at your DNS provider, then verify on the same service:

lizard domain verify app.example.com --service web

For an apex domain such as example.com, most DNS providers don’t allow a CNAME. Create an ALIAS or ANAME record with the same target instead, or use your provider’s CNAME flattening.

List a service’s domains

lizard domain list --service web

Move a domain from another of your services

lizard domain app.example.com --service web --force

Remove a domain

lizard domain delete app.example.com --service web
lizard domain rm app.example.com --service web --yes

See also

Updated