Stado

CLI reference / fleet

stado fleet

Invocation

stado fleet <COMMAND>

Purpose

Add machines to the fleet, group them, hold their SSH keys, and diagnose the workers: enroll, join/approve, key, doctor

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

  • doctor — Diagnose worker health: agent grant, secret probes, beacons, capacity
  • needs — What the fleet lacks: RAM on which host, storage where, a GPU, a platform nobody declared — from the capacity publications, the declared watermarks, the queue and the recorded refusals
  • expansion — Compare evidenced expansion options within a total expenditure budget
  • list — List the fleets declared in the registry with their members
  • status — Show live state for the members of one named fleet
  • create — Declare a new fleet in the canonical registry
  • assign — Add a registered machine to a declared fleet
  • unassign — Take a registered machine out of its fleet; the machine stays in the registry. A machine in no fleet is reported and left unchanged
  • delete — Retire a declared fleet. Refused while any target still points at it: deleting the declaration under a member would leave the document naming a fleet that does not exist, and `fleet list` refuses exactly that shape. Reassign or unassign the members first
  • enroll — One-command onboarding: register a machine, optionally fleet it, optionally install the agent
  • invite — Mint an invite: something the machine's owner runs, no access needed
  • invites — List minted invites with the state each is actually in
  • revoke-invite — Retire an invite so it can no longer be redeemed
  • ingress — Stand up, inspect or tear down the public entrance the one-line invite mode needs — a narrow enrollment listener behind a Cloudflare quick tunnel, with no Cloudflare account, token or DNS record involved
  • methods — Every way a machine can be added, and whether this fleet allows it
  • join — Announce this machine to the fleet (run on the machine being added)
  • pending — List unanswered join requests
  • approve — Turn a pending join request into a registered target
  • reject — Drop a pending join request
  • catalog — Print the central enrollment and communication catalog
  • key — SSH host keys in the globally selected credential store