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

# Install Ultra

> Install the Ultra binary on macOS, Linux, or Windows

<Note>
  For enterprise fleet deployment via Jamf Pro, see the [MDM Deployment Guide](/installation/mdm-deployment). It covers zero-touch installation, deploy key authentication, and per-user identity resolution via SCIM.
</Note>

<Tabs>
  <Tab title="Download from Website">
    ## Download Ultra

    Visit [ultra.security](https://ultra.security) and download the installer for your platform.

    ### macOS

    Download the signed and notarized `.pkg` installer and double-click to install.

    You can also download the `.pkg` directly:

    ```
    https://get.ultra.security/v{VERSION}/Ultra-{VERSION}-macOS.pkg
    ```

    ### Linux & Windows

    Download the binary for your platform from the website and place it in your PATH.

    ### Verify Installation

    After installing, open your AI client and ask it to verify:

    * *"Check your connection to Ultra"*
    * *"Run ultra doctor"*

    Your client should confirm that Ultra is installed and running.
  </Tab>

  <Tab title="CLI">
    ## Install via Terminal

    Run the install script:

    ```bash theme={null}
    curl -sSL https://get.ultra.security/install.sh | sh
    ```

    The install script:

    * Auto-detects your OS (macOS, Linux, Windows) and architecture (amd64, arm64)
    * Downloads from CDN (`get.ultra.security`) with GitHub Releases fallback
    * Installs to `/usr/local/bin` (or uses `sudo` if needed)
    * Removes macOS quarantine attributes automatically

    ### Environment Variables

    Customize the installation with environment variables:

    | Variable      | Default          | Description                   |
    | ------------- | ---------------- | ----------------------------- |
    | `INSTALL_DIR` | `/usr/local/bin` | Custom installation directory |
    | `VERSION`     | Latest release   | Pin to a specific version     |

    ```bash theme={null}
    # Install to a custom directory
    INSTALL_DIR=~/.local/bin curl -sSL https://get.ultra.security/install.sh | sh

    # Install a specific version
    VERSION=0.5.0 curl -sSL https://get.ultra.security/install.sh | sh
    ```

    ### Verify Installation

    After installing, verify Ultra is working:

    ```bash theme={null}
    ultra version
    ```

    Run diagnostics to check your system:

    ```bash theme={null}
    ultra doctor
    ```

    ### Upgrading

    Re-run the install script to upgrade to the latest version:

    ```bash theme={null}
    curl -sSL https://get.ultra.security/install.sh | sh
    ```
  </Tab>
</Tabs>

## Platform Support

| Platform | Architecture          | Status    |
| -------- | --------------------- | --------- |
| macOS    | Intel (amd64)         | Supported |
| macOS    | Apple Silicon (arm64) | Supported |
| Linux    | amd64                 | Supported |
| Linux    | arm64                 | Supported |
| Windows  | amd64                 | Supported |

<Warning>
  After installing or upgrading Ultra, **restart your MCP client** (e.g., quit and reopen Claude Desktop, Cursor, etc.) for changes to take effect.
</Warning>

<Note>
  Ultra is distributed from a private repository. `go install` is not available. Use the website download or install script.
</Note>

## Next Steps

<Card title="Configure Clients" icon="wrench" href="/installation/configure-clients">
  Set up your MCP clients to use Ultra
</Card>