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

# Local and on-prem setup

> Run HealOps locally with the CLI binary and onboard integrations from your environment

This guide is for teams running HealOps with the local `healops` CLI binary on developer machines, VMs, or on-prem
hosts.

## What mode should I use?

Use the mode that matches where your workloads and alerts live:

* **Local laptop mode** for fast setup, testing, and debugging
* **On-prem VM/server mode** for shared internal environments
* **Container mode** for reproducible deployments in Docker

Environment-specific install steps live under the `Installation` tab:

* [macOS](/environments/macos)
* [Linux (local)](/environments/linux-local)
* [Windows (local)](/environments/windows-local)
* [Docker](/environments/docker)

## Local setup workflow

### 1) Install the HealOps CLI

<Tabs>
  <Tab title="macOS / Linux">
    **Homebrew:**

    ```bash theme={null}
    brew tap healops-ai/tap
    brew install healops-ai/tap/healops
    ```

    **curl installer:**

    ```bash theme={null}
    curl -fsSL https://install.healops.ai | bash
    ```
  </Tab>

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

### 2) Enter the HealOps shell

```bash theme={null}
healops
```

### 3) Run onboarding

From inside the HealOps shell:

```bash theme={null}
onboard
```

`onboard` helps you configure:

* LLM provider (for investigation reasoning)
* integration credentials
* optional communication/reporting integrations

### 4) Verify integration health

From inside the HealOps shell:

```bash theme={null}
integrations verify
```

To verify one integration:

```bash theme={null}
integrations verify <integration-name>
```

### 5) Run your first investigation

**From inside the HealOps shell** (after running bare `healops`):

```bash theme={null}
investigate -i tests/e2e/kubernetes/fixtures/datadog_k8s_alert.json
```

**From your normal terminal** (direct investigation, no shell):

```bash theme={null}
healops investigate -i tests/e2e/kubernetes/fixtures/datadog_k8s_alert.json
```

## Integration catalog

The full integration catalog is maintained under the `Integrations` tab.

Start here:

* [Integrations overview](/integrations-overview)
* [CLI Integration Setup](/cli-integration-setup)

Then open each provider page for credentials, minimum permissions, and setup examples.

## Related guides

* [Quickstart](/quickstart)
* [Investigations overview](/investigation-overview)