Skip to content

nyx_domain_status

Show one domain’s current state — phase, conditions, and the CNAME/A target. While the operator is provisioning the certificate the response includes a “next action” hint so an agent caller knows what to do.

With —watch the CLI polls every 5s and renders a single-line status update until the domain reaches phase=Ready (exit 0) or the timeout fires (non-zero exit, code: timeout). —watch implies the non-interactive contract: —json mode is honored, and a non-tty stdin doesn’t trigger any prompt.

Standard flow:

nyx domain status app.acme.com nyx domain status app.acme.com —watch nyx domain status app.acme.com —watch —timeout 5m —json

ArgumentRequired
hostnameyes
FlagTypeDefaultDescription
--contextstringOverride the active context for this invocation (also: NYX_CONTEXT env var)
--jsonboolfalseEmit one JSON envelope per invocation (stdout for success, stderr for errors)
--timeoutduration10m0sWatch timeout (e.g. 5m, 30s). Ignored without —watch
--watchboolfalsePoll every 5s and exit when phase=Ready (or on timeout/failed)

Generated from tree.json @ fallbac.