Skip to main content
Version: v5.7.0

opschain admin runner

Included from Basic tier

Operates one runner of the fleet, addressed by its runner id (from opschain admin runners list). Every subcommand targets the server's admin-gated fleet API and authenticates with an admin token (--auth-token, $OPSCHAIN_ADMIN_TOKEN, or the token stored by opschain admin login); the server comes from --server, OPSCHAIN_SERVER or the active context.

SubcommandDoes
showOne runner in full: identity, lifecycle, drain state, jobs, host inventory — opschain docs cli/admin-runner-show
drainFinish in-flight steps, take nothing new — opschain docs cli/admin-runner-drain
resumeLift the runner's drain — opschain docs cli/admin-runner-resume
forgetRemove a stale registration (not revocation) — opschain docs cli/admin-runner-forget

Group-wide operations live under opschain admin runner-group (opschain docs cli/admin-runner-group); the fleet-wide listing under opschain admin runners (opschain docs cli/admin-runners). How all of this shapes dispatch: opschain docs fleet-queue.