oz0 doctor

Check the setup the CLI context points at (--context, $OZ0_CONTEXT, or the default context), from this machine.

For: Operators and developers looking up a command.

Check the setup the CLI context points at (--context, $OZ0_CONTEXT, or the default context), from this machine. It checks:

  • The edge's Temporal port (7233) and API port (7443): connections and TLS with a certificate of the cluster's CA that is not about to end.
  • This machine's clock against the edge's, and the operator certificate.
  • Management: the database and its migrations, the servers, the cluster CA, the nodes and their certificates.
  • The edge: the tenant's Temporal namespace and each model key the tenant has, checked with the provider's list of models, which spends no tokens.
  • The tenant's tool policy: each warning of oz0 policy lint, for whoever may read the tool policy.
  • The free disk space of --data-dir or the context's folder.

On a node, run oz0-node doctor. 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 doctor [flags]

Flags

FlagTypeDefaultDescription
--data-dirstringthe context's foldera server's data directory, whose disk space to check
--edge-apistringcheck this edge API address (host:port) instead of the context's
--edge-temporalstringcheck this edge Temporal address (host:port) instead of the context's
--jsonboolprint the checks as JSON
--skip-model-keysboolleave out the model keys' checks, which call the providers
--tenantstringdefaulttenant whose Temporal namespace, model keys and tool policy to check

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