oz0-node service install
For: Operators and developers looking up a command.
Install the node as a service and start it; run it again to update the service, such as after moving the binary. A service of the machine runs as its own account (Linux: oz0-node, made when it does not exist; macOS: --account, by default the user who ran sudo; Windows: the virtual account NT SERVICE<name>), which gets the data directory and a copy of the binary in <data-dir>/bin to update.
Join first with the same --data-dir: a service starts only while the node has its identity, so a purged node stays stopped. --dry-run prints the unit, property list or service settings without installing them. A stop drains the node first: the service manager waits for its stop grace (--stop-grace, ten minutes by default) and a minute more before it kills it.
Usage
oz0-node service install [flags]
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--account | string | oz0-node on Linux, the user who ran sudo on macOS, NT SERVICE\<name> on Windows | the account a service of the machine runs as |
--check | bool | check that the service can be installed here, as the install scripts do before they join, and change nothing | |
--dry-run | bool | print the service's definition and where it would go, and change nothing | |
--no-linger | bool | systemd user service: do not turn on lingering, so the node runs only while you are logged in | |
--no-start | bool | install and enable the service, but do not start it now | |
--plugin-sandbox | string | the node's, strict on a node with tier 1 | the service's oz0-node run --plugin-sandbox: auto or off, for a node that must not hold its plugins to the sandbox |
--plugin-sandbox-exempt | stringArray | the service's oz0-node run --plugin-sandbox-exempt, PLUGIN or PLUGIN@COMMIT (repeatable); installing the service again without it takes the exemption away | |
--replace-binary | bool | service of the machine: put this binary in place of the service's own copy even when that copy is newer or its version is not known | |
--service-name | string | orchestrator-zero-node | the service's name, for more than one node on a machine (launchd label ai.oz0.<name>) |
--stop-grace | duration | 10m0s | how long the node drains when the service stops, at most 1h; the service manager waits a minute more |
--system | bool | as root or Administrator | a service of the machine that starts at boot and runs as its own account |
--user | bool | when not root | a service of your own user: systemd's user manager, or a launchd agent |
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.