Skip to main content
1

Install HealOps

Homebrew (recommended):
curl installer:
pip (Python 3.12+):
2

Onboard

Run the onboarding wizard to configure your LLM provider and connect your integrations (Grafana, Datadog, Honeycomb, Coralogix, Slack, AWS, GitHub, Sentry):
3

Run an investigation

Choose either path — both use the same local healops CLI:Interactive prompt shell — start HealOps with no arguments (TTY) to type incidents in plain language and use slash commands (/help, /status, /effort, /exit, …):
Direct investigation — one-shot run from your shell with an alert file:
For file-based runs, HealOps fetches alert context, reasons across connected systems, and generates a structured root-cause report.
4

Keep up to date

​
Uninstall

To remove HealOps and all its local data from your machine:
Pass --yes to skip the confirmation prompt:

​
Troubleshooting

  • Docker is not running: Start Docker Desktop, OrbStack, or Colima before running setup.
  • make is missing: Install it via your package manager (brew install make on macOS, choco install make on Windows).
  • No local LLM provider is configured: Run healops onboard to select and configure your LLM credentials.