Skip to main content
Manage custom domains for your apps.

​
add

Add a custom domain to an app. Returns DNS configuration instructions. 
floo domains add myapp.com --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID (reads from config if omitted)
--services SVCTarget service name (required for multi-service apps)

​
JSON output

{
  "success": true,
  "data": {
    "hostname": "myapp.com",
    "status": "pending",
    "dns_instructions": "Add a CNAME record: myapp.com -> my-app.on.getfloo.com"
  }
}

​
list

List all custom domains for an app. 
floo domains list --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID (reads from config if omitted)
--services SVCFilter to a single target service

​
JSON output

{
  "success": true,
  "data": {
    "domains": [
      {
        "hostname": "myapp.com",
        "status": "pending",
        "dns_instructions": "Add a CNAME record: myapp.com -> my-app.on.getfloo.com"
      }
    ]
  }
}

​
status

Show detailed status for a single custom domain (hostname, DNS target, and current verification state). 
floo domains status myapp.com --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID (reads from config if omitted)

​
JSON output

{
  "success": true,
  "data": {
    "hostname": "myapp.com",
    "status": "pending",
    "dns_instructions": "Add a CNAME record: myapp.com -> my-app.on.getfloo.com"
  }
}

​
Errors

CodeMeaning
DOMAIN_NOT_FOUNDNo domain with that hostname on this app

​
verify

Verify DNS for a pending custom domain. Checks that the CNAME record resolves to the expected floo gateway host. 
floo domains verify myapp.com --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID (reads from config if omitted)

​
JSON output

{
  "success": true,
  "data": {
    "hostname": "myapp.com",
    "status": "active",
    "dns_instructions": "Add a CNAME record: myapp.com -> my-app.on.getfloo.com"
  }
}

​
Errors

CodeMeaning
DOMAIN_NOT_FOUNDNo domain with that hostname on this app
DOMAIN_ALREADY_VERIFIEDDomain is already active
DOMAIN_VERIFICATION_FAILEDCNAME not found or points to wrong host

​
watch

Poll a pending domain until it goes active, reports a terminal failure, or the timeout expires. Useful in CI or while waiting on DNS propagation. 
floo domains watch myapp.com --app my-app

​
Flags

FlagDescriptionDefault
--app APPApp name or UUID (reads from config if omitted)—
--timeout SECSMaximum seconds to wait before exiting with a timeout error300
The command polls the verify endpoint every 5 seconds. Exits 0 when the domain reaches active, non-zero on DNS verification failure or timeout.

​
JSON output (on success)

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

​
remove

Remove a custom domain from an app. 
floo domains remove myapp.com --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID (reads from config if omitted)
--services SVCTarget service name (required for multi-service apps)

​
JSON output

{
  "success": true,
  "data": {
    "hostname": "myapp.com"
  }
}

​
Errors

CodeMeaning
NOT_AUTHENTICATEDRun floo auth login first
APP_NOT_FOUNDNo app with that name or ID