oz0-node doctor

Usage and flags for oz0-node doctor.

For: Operators and developers looking up a command.

Check this machine as a node, from the data directory: that it has joined, and that its certificate is not about to end; that the edge's Temporal port (7233) and API port (7443) take connections from here, and answer TLS with a certificate of the cluster's CA; this machine's clock against the edge's; the data directory's free disk space (a node over 95% full takes no work); the sandbox tier it can run (tier 1 for harness sessions and outside-started jobs); and each model server in models.yaml, on loopback only.

It does not need the node to be running. Each check that is not ok says how to fix it. Exits 0 when every check is ok, 2 when the worst is a warning, 1 when one failed; --json prints the checks for scripts.

Usage

oz0-node doctor [flags]

Flags

FlagTypeDefaultDescription
--jsonboolprint the checks as JSON
--modelsstring<data-dir>/models.yamlthe model servers file to check

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