oz0-node drain

Usage and flags for oz0-node drain.

For: Operators and developers looking up a command.

Ask the node that runs with this data directory to drain, as it does when it is stopped: it takes no new job and starts no new session, and what runs finishes within its stop grace. The node keeps running; stop it afterwards, and its stop waits only for what is left of the same grace. With --wait, return once nothing runs there or the grace has passed. A Kubernetes pod's preStop hook runs this.

Usage

oz0-node drain [flags]

Flags

FlagTypeDefaultDescription
--timeoutduration1h0m0sthe longest --wait waits
--waitboolwait until nothing runs on the node, or its stop grace has passed

Inherited flags

FlagTypeDefaultDescription
--data-dirstring~/.local/share/orchestrator-zero-nodewhere the node keeps its identity, uv, Python, runtimes and state
--log-levelstringinfolog level: debug, info, warn or error

See all oz0-node commands and the global flags.

On this page
Copyright © 2026