> ## Documentation Index
> Fetch the complete documentation index at: https://docs.harbormcp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install Harbor with a single command, or download the desktop app.

## Quick Install

The fastest way to install Harbor:

<Tabs>
  <Tab title="macOS / Linux">
    ```sh theme={null}
    curl -fsSL https://harbormcp.ai/install.sh | sh
    ```
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    irm https://harbormcp.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

On **macOS**, this installs the desktop app to `/Applications` and adds the `harbor` CLI to your PATH.
On **Linux**, this installs the `harbor` CLI binary.
On **Windows**, this downloads and runs the MSI installer silently.

### Options

| Environment Variable | Description                                                     |
| -------------------- | --------------------------------------------------------------- |
| `HARBOR_VERSION`     | Install a specific version (e.g. `HARBOR_VERSION=0.2.4`)        |
| `HARBOR_NO_APP`      | Set to `1` for CLI-only install on macOS (skips desktop app)    |
| `HARBOR_INSTALL_DIR` | Override CLI install directory (Linux and `HARBOR_NO_APP` only) |

## Desktop App

You can also download the desktop app directly:

<Card title="Download Harbor" icon="download" href="https://github.com/JoshuaShunk/Harbor/releases/latest">
  Available for macOS (Apple Silicon & Intel), Windows, and Linux.
</Card>

1. Download the installer for your platform from the [latest release](https://github.com/JoshuaShunk/Harbor/releases/latest)
2. Run the installer (`.dmg` on macOS, `.msi` on Windows, `.deb`/`.AppImage` on Linux)
3. Launch Harbor

## CLI Only

Install the CLI without the desktop app:

```sh theme={null}
# macOS (CLI only, no .app)
curl -fsSL https://harbormcp.ai/install.sh | HARBOR_NO_APP=1 sh

# Or build from source
git clone https://github.com/JoshuaShunk/Harbor.git
cd Harbor
cargo install --path crates/harbor-cli
```

Once installed, verify it's working:

```sh theme={null}
harbor --version
```

## Uninstalling

To uninstall Harbor:

```sh theme={null}
harbor scuttle
```

Or via the install script:

<Tabs>
  <Tab title="macOS / Linux">
    ```sh theme={null}
    curl -fsSL https://harbormcp.ai/install.sh | sh -s -- --uninstall
    ```
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    $env:HARBOR_UNINSTALL=1; irm https://harbormcp.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

Use `harbor scuttle --purge` to also remove config files and vault secrets.

## Next Steps

<Card title="Dock Your First Server" icon="anchor" href="/quickstart/first-server">
  Add an MCP server and sync it to all your hosts.
</Card>