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

# CLI Installation

> Install the DevHelm CLI via npm, verify the installation, and keep it updated

The DevHelm CLI is distributed as an npm package. Install it globally to manage monitors, deploy configs, and interact with the API from your terminal.

## Requirements

* **Node.js 18** or later
* **npm** (included with Node.js)

## Install

```bash theme={null}
npm install -g devhelm
```

Verify the installation:

```bash theme={null}
devhelm --version
```

## Pin a specific version

For reproducible CI builds, install an exact version (latest stable: **1.3.0**):

```bash theme={null}
npm install -g devhelm@1.3.0
```

## Update

```bash theme={null}
npm install -g devhelm@latest
```

To check which version you're running:

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

## GitHub Actions

Use the official `setup-devhelm` action to install and configure the CLI in CI:

```yaml theme={null}
- uses: devhelmhq/setup-devhelm@v1
  with:
    api-token: ${{ secrets.DEVHELM_API_TOKEN }}
```

The action handles Node.js setup, npm caching, and environment variable configuration. See [GitHub Actions integration](/integrations/github-actions) for the full reference.

## Uninstall

```bash theme={null}
npm uninstall -g devhelm
```

To also remove saved credentials:

```bash theme={null}
rm -rf ~/.devhelm
```

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/cli/authentication">
    Set up API tokens and saved contexts.
  </Card>

  <Card title="CLI Quickstart" icon="rocket" href="/cli/quickstart">
    Create your first monitor from the terminal.
  </Card>
</CardGroup>
