CLI reference / web / origin

stado web origin

Invocation

stado web origin <COMMAND>

Purpose

Public origins: the hostnames the internet reaches a Stado surface through, and whether anything outside this network can resolve them

Required inputs and options

This command has no command-specific inputs or options.

Output and state effect

This command group selects one of the subcommands listed below; use its exact child invocation to perform an operation.

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.

Subcommands

  • list — List every declared public origin
  • status — Report each declared origin's public resolution, its target's publication, and the origin the live public edge actually selected
  • declare — Declare one public origin in the canonical registry
  • remove — Withdraw one declared public origin
  • withdraw — Withdraw every public HTTPS Funnel handler on TARGET, including undeclared paths, and remove its public-origin declarations. Private backend processes are not stopped
  • converge — Make the declared publication carry every declared path, then read the publication and the public name back. A `web-edge` origin converges through `stado web route` for the declaration that owns its hostname; a `tailscale-funnel` origin through the node's own handler table
  • url — Print the public URL of PATH on the one declared origin that publishes it, with each `--query KEY=VALUE` appended URL-encoded