CLI reference / service / env-set

stado service env-set

Invocation

stado service env-set [OPTIONS] --host <HOST> --key <KEY> --env-file <ENV_FILE> --value-file <VALUE_FILE> <NAME>

Purpose

Replace one key in a managed runtime env file or systemd definition. The value is read from an owner-only local file and travels only inside the approved encrypted channel's request body. A systemd unit or its own .conf drop-in is updated in place; the manager reloads changed definitions without restarting the running service.

Required inputs and options

Input or optionContract
<NAME>Service whose host-local process reads the environment
--host <HOST>The single registry host to update
--key <KEY>Exact environment variable name
--env-file <ENV_FILE>Runtime env file, or this service's exact systemd unit/drop-in path
--value-file <VALUE_FILE>Absolute owner-only local file containing the value
--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.