---
title: "oz0 tenant egress"
description: "Usage and flags for oz0 tenant egress."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/tenant/egress"
---
# oz0 tenant egress

> Usage and flags for oz0 tenant egress.

For: Operators and developers looking up a command.

Harness sessions, and the jobs an outside event such as a webhook starts, run in sandbox tier 1 on nodes that have it, where the network goes only through the node's egress proxy. The proxy allows the hosts the tenant lists here, the hosts the process's plugin lists (egress in oz0-plugin.yaml) and those its agent lists, and denies the rest; denials show in the job's live stream and in `job get`.

The verified plugins' tools that reach hosts for a model (ai.oz0/web's fetch, net-diag's probes, cve-triage's OSV lookups) hold themselves to the same lists on every node, sandboxed or not.

A host is a name (api.github.com, on ports 80 and 443), a wildcard (*.example.com), name:port, name:* or an IP address. Hosts given here replace the list; with none, the list is shown. --clear empties it.

A list that allows anything the tenant's list did not is a reviewed change: it waits as a change request, with what it widens, until a tenant admin approves it (oz0 change approve); --approve approves it at once after printing its delta, when the tenant's review-widening lets you. A narrowing applies at once.

A new entry that reaches a host serving files anyone can publish (a code host's raw files, a package registry, an object store, a paste site) says so on its finding, since a session that may reach it may download and run whatever is there. That is a reason to look, not a verdict: nothing is refused for it, and approving applies it.

## Usage

```bash
oz0 tenant egress <tenant> [host...] [flags]
```

## Flags

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

<tbody>
  <tr>
    <td>
      <code>
        --approve
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      approve the change request a widening makes at once, after printing its delta
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --clear
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      empty the tenant's list
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --decision-ref
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      the decision or case the change follows, such as a case number (at most 200 characters)
    </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, required for every governance change (at most 500 characters; default $OZ0_REASON); the audit log keeps it
    </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.