---
title: "oz0 node drain"
description: "Drain a node."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/node/drain"
---
# oz0 node drain

> Drain a node.

For: Operators and developers looking up a command.

Drain a node. It takes no new job and starts no new session; the work it runs, and the tool calls of the jobs homed on it, go on until they end or the deadline passes. Past the deadline the node takes nothing and stops what still runs, which is then lost. `oz0 node show` says "safe to stop" once nothing runs there. Draining a node that drains moves its deadline. Undrain it when it is back.

## Usage

```bash
oz0 node drain <node-id> [--deadline 2h] [flags]
```

## Flags

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

<tbody>
  <tr>
    <td>
      <code>
        --deadline
      </code>
    </td>
    
    <td>
      duration
    </td>
    
    <td>
      <code>
        2h0m0s
      </code>
    </td>
    
    <td>
      how long what runs on the node may go on, from a minute to seven days
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --json
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      print JSON instead of a table
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --reason
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      why, for the audit log, such as a patch window
    </td>
  </tr>
</tbody>
</table>

## Inherited flags

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

<tbody>
  <tr>
    <td>
      <code>
        --context
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        $OZ0_CONTEXT or &lt;config dir>/orchestrator-zero/context.json
      </code>
    </td>
    
    <td>
      CLI context file written by server init
    </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>

See [all `oz0` commands](https://docs.oz0.ai/reference/cli/oz0) and the [global flags](https://docs.oz0.ai/reference/cli/oz0#global-flags).


## Sitemap

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