CLI reference / host / publish-beacon

stado host publish-beacon

Invocation

stado host publish-beacon [OPTIONS] <SOURCE>

Purpose

Publish one locally collected beacon through the scoped Stado health API. The `link` block (tailnet path, sleep/wake, interface changes) is collected here, on the host, and merged into the document about this machine before it is published.

Required inputs and options

Input or optionContract
<SOURCE>JSON beacon file, or '-' for stdin
--printPrint the document that would be published; publish nothing

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.