---
title: "oz0 connection start"
description: "Start a connection's steps and print the URL to open in your browser, within 15 minutes; it works once."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/connection/start"
---
# oz0 connection start

> Start a connection's steps and print the URL to open in your browser, within 15 minutes; it works once.

For: Operators and developers looking up a command.

Start a connection's steps and print the URL to open in your browser, within 15 minutes; it works once. The steps go through the other system's pages, such as GitHub's to register and install an app, and end at
the edge's HTTPS port (--public-edge-url on the server), which must be reachable from your browser.

A connected connection stays in effect until a new flow from its restart step (connection show) is done;
starting from an earlier step, such as registering another GitHub App, needs --replace and cuts it off at once. A param with choices picks which steps run (connection show says when each runs), such as account=user for
a GitHub App on your own account instead of an organization's.

When the last step is done, the functions the
connection runs after connecting start as tool jobs (connection show lists them). Some steps run on the edge's own page instead: a link that creates your own app on the other system
with everything filled in, values to copy into its settings, and fields you paste back there, never here. Each is checked before the next step. The steps go to stderr as they start; --wait follows them.

## Usage

```bash
oz0 connection start <connection> [flags]
```

## Flags

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

<tbody>
  <tr>
    <td>
      <code>
        --from-step
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      start at this step, such as install to install a registered app on another account
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --open
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      open the URL in the default browser, if it is an http or https address
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --param
      </code>
    </td>
    
    <td>
      stringToString
    </td>
    
    <td>
      <code>
        []
      </code>
    </td>
    
    <td>
      a param of the connection, name=value; repeatable (default: the ones set before)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --quiet
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      print only the URL
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --replace
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      replace a connected connection from a step before its restart step; its calls get the fallback secret until the new flow is done
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --return-url
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        a page that says so
      </code>
    </td>
    
    <td>
      where the browser goes when the steps are done: an address on the edge, the web console or one of the tenant's CORS origins
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --tenant
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        default
      </code>
    </td>
    
    <td>
      tenant
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --wait
      </code>
    </td>
    
    <td>
      duration
    </td>
    
    <td>
      
    </td>
    
    <td>
      follow the steps and their checks until the connection is connected or fails, at most this long, such as 15m
    </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.