CLI reference / web / origin / declare

stado web origin declare

Invocation

stado web origin declare [OPTIONS] --hostname <HOSTNAME> --target <TARGET> --upstream <UPSTREAM> --path <PATHS> <NAME>

Purpose

Declare one public origin in the canonical registry. Refused before any write when the hostname has no public A or AAAA record: a name nothing outside this network can resolve is not a public origin, whatever is listening behind it.

Required inputs and options

Input or optionContract
<NAME>Lowercase identity for this origin, such as `release-object`
--hostname <HOSTNAME>The public DNS name a client resolves; no scheme, port or path
--target <TARGET>Registry target whose publication serves it
--publication <PUBLICATION>How that target publishes it [default: tailscale-funnel] [possible values: tailscale-funnel]
--upstream <UPSTREAM>Loopback origin on the target the publication forwards to
--path <PATHS>An absolute path this origin publishes; repeatable
--jsonEmit machine-readable output

Output and state effect

It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.