domains

Read custom-domain status and DNS records. Declare or remove hosts in floo.app.toml and release to prod; see Custom domains.

Status	Meaning
`pending`	Waiting on DNS and certificate issuance; another app may claim the host if it is still pending 14 days after the release
`active`	The host is serving
`failed`	The certificate failed to issue; the status message says why. Fixing the `_acme-challenge` record lets floo retry
`removed`	The host is retired

list

List custom domains for an app.

floo domains list --app my-app

Flags

Flag	Description
`--app APP`	App name or UUID (reads from config if omitted)
`--json`	Machine-readable output

JSON output

Selected fields after the certificate record is available:

{
  "success": true,
  "data": {
    "domains": [
      {
        "hostname": "shop.example.com",
        "status": "pending",
        "dns_instructions": "Add a CNAME record: shop.example.com -> edge.getfloo.com\n  At a zone apex (a domain with no subdomain, e.g. example.com), a CNAME is not allowed. Use your DNS provider's ALIAS or ANAME record type pointing to edge.getfloo.com, or add A records pointing to: 34.117.26.37.\nAdd a CNAME record: _acme-challenge.shop.example.com -> <target printed by floo>"
      }
    ]
  }
}

show

Show a host’s status and DNS instructions, including the traffic record and the per-certificate CNAME target. The certificate target appears within a minute of the prod release. Until then, the instructions say the ACME records will be available on the next check. The output also includes apex traffic guidance.

floo domains show shop.example.com --app my-app

Flags

Flag	Description
`--app APP`	App name or UUID (reads from config if omitted)
`--json`	Machine-readable output

JSON output

Selected fields after the certificate record is available:

{
  "success": true,
  "data": {
    "hostname": "shop.example.com",
    "status": "pending",
    "dns_instructions": "Add a CNAME record: shop.example.com -> edge.getfloo.com\n  At a zone apex (a domain with no subdomain, e.g. example.com), a CNAME is not allowed. Use your DNS provider's ALIAS or ANAME record type pointing to edge.getfloo.com, or add A records pointing to: 34.117.26.37.\nAdd a CNAME record: _acme-challenge.shop.example.com -> <target printed by floo>"
  }
}

Errors

Code	Meaning
`DOMAIN_NOT_FOUND`	No domain with that hostname on this app

watch

Wait until a domain is active or failed, or the timeout expires. floo checks DNS and certificate state every minute and activates the host automatically; watch observes that status.

floo domains watch shop.example.com --app my-app

Flags

Flag	Description	Default
`--app APP`	App name or UUID (reads from config if omitted)	inferred from config
`--timeout SECS`	Maximum seconds to wait	`300`
`--json`	Machine-readable output	off

The command exits 0 when the domain reaches active, non-zero on failure or timeout. A timeout stops the command; floo continues checking the domain.

JSON output (on success)

{
  "success": true,
  "data": {
    "hostname": "shop.example.com",
    "status": "active"
  }
}

CLI

Config

list

Flags

JSON output

show

Flags

JSON output

Errors

watch

Flags

JSON output (on success)

​list

​Flags

​JSON output

​show

​Flags

​JSON output

​Errors

​watch

​Flags

​JSON output (on success)

list

Flags

JSON output

show

Flags

JSON output

Errors

watch

Flags

JSON output (on success)