---
title: "Obot CLI Setup"
version: "v0.27.0"
canonical: "https://docs.obot.ai/v0.27.0/installation/cli-setup"
unreleased: false
---

# Obot CLI Setup

For the current task-based instructions, see [CLI and APIs](https://docs.obot.ai/v0.27.0/reference/cli-api.md). This page preserves existing bookmarks.

<a id="obot-doc-what-it-does"></a>

## What it does

Continue to [What it does](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup-what-it-does).

<a id="obot-doc-prerequisites"></a>

## Prerequisites

Continue to [Prerequisites](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup-prerequisites).

<a id="obot-doc-basic-usage"></a>

## Basic usage

Continue to [Basic usage](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup-basic-usage).

<a id="obot-doc-choosing-local-client-targets"></a>

## Choosing local client targets

Continue to [Choosing local client targets](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup-choosing-local-client-targets).

<a id="obot-doc-non-interactive-setup"></a>

## Non-interactive setup

Continue to [Non-interactive setup](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup-non-interactive-setup).

<a id="obot-doc-check-setup-status"></a>

## Check setup status

Continue to [Check setup status](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup-check-setup-status).

<a id="obot-doc-what-setup-writes-locally"></a>

## What setup writes locally

Continue to [What setup writes locally](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup-what-setup-writes-locally).

<a id="obot-doc-troubleshooting"></a>

## Troubleshooting

Continue to [Troubleshooting](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup-troubleshooting).

<a id="obot-doc-auth_unavailable"></a>

### `auth_unavailable`

Continue to [`auth_unavailable`](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup-auth_unavailable).

<a id="obot-doc-server_unreachable"></a>

### `server_unreachable`

Continue to [`server_unreachable`](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup-server_unreachable).

<a id="obot-doc-missing---url-in-non-interactive-mode"></a>

### Missing `--url` in non-interactive mode

Continue to [Missing `--url` in non-interactive mode](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup-missing---url-in-non-interactive-mode).

<a id="obot-doc---clients-is-required-in-non-interactive-mode"></a>

### `--clients is required in non-interactive mode`

Continue to [`--clients is required in non-interactive mode`](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup---clients-is-required-in-non-interactive-mode).

<a id="obot-doc-existing-url-mismatch"></a>

### Existing URL mismatch

Continue to [Existing URL mismatch](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-cli-setup-existing-url-mismatch).

<a id="obot-doc-authenticate-providers-that-require-localhost-callbacks"></a>

## Authenticate providers that require localhost callbacks

Continue to [MCP localhost OAuth sign-in](https://docs.obot.ai/v0.27.0/reference/cli-api.md#obot-doc-mcp-localhost-oauth-sign-in).