---
title: "oz0-node"
description: "The node binary: join a cluster and run agents on this machine."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0-node"
---
# oz0-node

> The node binary: join a cluster and run agents on this machine.

For: Operators and developers looking up a command.

Orchestrator Zero node: runs agents on this machine

`oz0-node` and `orchestrator-zero-node` run the same commands. The build and install scripts provide both names.

## Usage

```bash
oz0-node [command]
```

## Global flags

These flags apply to every command.

<table>
<thead>
  <tr>
    <th>
      Flag
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Default
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --data-dir
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        ~/.local/share/orchestrator-zero-node
      </code>
    </td>
    
    <td>
      where the node keeps its identity, uv, Python, runtimes and state
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --log-level
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        info
      </code>
    </td>
    
    <td>
      log level: debug, info, warn or error
    </td>
  </tr>
</tbody>
</table>

## Command index

Each entry opens a separate reference page. Existing section links still land on the matching entry here.

- <span id="doctor">

`doctor`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/doctor).
- <span id="drain">

`drain`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/drain).
- <span id="join">

`join`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/join).
- <span id="prepare">

`prepare`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/prepare).
- <span id="release-channel">

`release-channel`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/release-channel).
- <span id="run">

`run`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/run).
- <span id="sandbox">

`sandbox`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/sandbox).
- <span id="sandbox-check">

`sandbox check`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/sandbox/check).
- <span id="sandbox-setup">

`sandbox setup`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/sandbox/setup).
- <span id="service">

`service`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/service).
- <span id="service-install">

`service install`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/service/install).
- <span id="service-status">

`service status`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/service/status).
- <span id="service-uninstall">

`service uninstall`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/service/uninstall).
- <span id="support">

`support`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/support).
- <span id="support-bundle">

`support bundle`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/support/bundle).
- <span id="toolchain">

`toolchain`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/toolchain).
- <span id="toolchain-fetch">

`toolchain fetch`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/toolchain/fetch).
- <span id="version">

`version`

</span>

: [usage and flags](https://docs.oz0.ai/reference/cli/oz0-node/version).


## Sitemap

See the full [sitemap](https://docs.oz0.ai/sitemap.md) for all pages.