domains

Custom-domain status and DNS records. Hosts are declared or removed in floo.app.toml and released 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

A host’s status and DNS instructions: the traffic record, apex traffic guidance, 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.

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

Poll a domain every 5 seconds until it is active, failed, or removed, or the timeout expires. floo checks DNS and certificate state every minute and activates the host itself; watch only observes.

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 and non-zero on failed, removed, or timeout. A timeout stops the command; floo keeps checking the domain.

JSON output (on success)

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

CLI

Config and runtime

Errors

API

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)