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

# Installation

> Install CatOps CLI

## Quick Install

```bash theme={null}
curl -fsSL https://get.catops.app/install.sh | bash
```

<Warning>
  Do NOT use `sudo`. The script installs to `$HOME/.local/bin/`.
</Warning>

## With Cloud Mode

To enable Telegram alerts, provide your auth token:

```bash theme={null}
curl -fsSL https://get.catops.app/install.sh | AUTH_TOKEN="your_token" bash
```

Get your token from [catops.app/billing](https://catops.app/billing).

## What Happens

The script will:

1. Download the CatOps binary
2. Install to `~/.local/bin/catops`
3. Add to your PATH
4. Create config at `~/.catops/config.yaml`
5. Set up autostart service
6. Start monitoring

## Verify Installation

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

If `catops` is not found, run:

```bash theme={null}
export PATH="$HOME/.local/bin:$PATH"
```

Or restart your terminal.

## Update

```bash theme={null}
catops update
```

Or reinstall:

```bash theme={null}
curl -fsSL https://get.catops.app/install.sh | bash
```

## Uninstall

```bash theme={null}
catops uninstall
```

Or manually:

```bash theme={null}
rm ~/.local/bin/catops
rm -rf ~/.catops
```

## Supported Systems

| OS    | Architecture         |
| ----- | -------------------- |
| Linux | x86\_64, ARM64       |
| macOS | Intel, Apple Silicon |

## Autostart

CatOps automatically sets up autostart:

* **Linux**: systemd user service
* **macOS**: launchd service

Check service status:

```bash theme={null}
catops status
```