CLI reference / service / adopt

stado service adopt

Invocation

stado service adopt [OPTIONS] <UNIT>

Purpose

Bring an existing launchd/systemd unit under management. The unit must already exist on the host — adoption claims what is there, it does not create anything. The host is probed first and the registry records what the host reported, not what was assumed.

Required inputs and options

Input or optionContract
<UNIT>launchd label or systemd unit name, as the host knows it
--host <HOST>Explicit registry host that runs it
--host-heuristic <HOST_HEURISTIC>Declarative placement selector resolved against the registry
--jsonCommand option; required or optional as shown in the invocation.

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.