oz0 node drain

Drain a node.

For: Operators and developers looking up a command.

Drain a node. It takes no new job and starts no new session; the work it runs, and the tool calls of the jobs homed on it, go on until they end or the deadline passes. Past the deadline the node takes nothing and stops what still runs, which is then lost. oz0 node show says "safe to stop" once nothing runs there. Draining a node that drains moves its deadline. Undrain it when it is back.

Usage

oz0 node drain <node-id> [--deadline 2h] [flags]

Flags

FlagTypeDefaultDescription
--deadlineduration2h0m0show long what runs on the node may go on, from a minute to seven days
--jsonboolprint JSON instead of a table
--reasonstringwhy, for the audit log, such as a patch window

Inherited flags

FlagTypeDefaultDescription
--contextstring$OZ0_CONTEXT or <config dir>/orchestrator-zero/context.jsonCLI context file written by server init
--log-levelstringinfolog level: debug, info, warn or error

See all oz0 commands and the global flags.

On this page
Copyright © 2026