oz0 node list

List nodes

For: Operators and developers looking up a command.

List nodes

Usage

oz0 node list [flags]

Flags

FlagTypeDefaultDescription
--allboolread every page, not one
--jsonboolprint JSON instead of a table
--limitint32at most this many rows a page (the server's 25 when 0, at most 100)
--page-tokenstringgo on after the page before: the token it printed
--pendingboolonly nodes waiting for approval (same as --state pending)
--querystringonly nodes whose ID, name or labels hold every word, without case
--statestringonly nodes in this state: pending, accepted, rejected, blocked or purging
--statusstringonly nodes in this condition: online, offline, pending, blocked, draining, purging, rejected or findings
--tenantstringonly this tenant's nodes

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