oz0-node join
Join a cluster.
For: Operators and developers looking up a command.
Join a cluster. The node creates its key locally (it never leaves the machine) and checks the server against the CA hash in the join token or --ca-hash before it sends anything. With a valid token it is accepted at once; without one it waits until an operator runs oz0 node accept.
Usage
oz0-node join [flags]
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--ca-hash | string | cluster CA hash (sha256:...) to join without a token and wait for approval | |
--name | string | host name | display name |
--region | string | the region this node belongs to, such as eu; the join fails unless --server is an edge of that region (default: the region of the edge it joins through). A node works only through its own region's edges | |
--server | string | edge address, for example https://edge.example.com:7443 (required) | |
--token-file | file | a file (- for stdin) holding the join token from oz0 token create (or set OZ0_JOIN_TOKEN); a token never goes on the command line, where every user of the machine can read it |
Inherited flags
| Flag | Type | Default | Description |
|---|---|---|---|
--data-dir | string | ~/.local/share/orchestrator-zero-node | where the node keeps its identity, uv, Python, runtimes and state |
--log-level | string | info | log level: debug, info, warn or error |
See all oz0-node commands and the global flags.