Okapi
Get a license

Okapi documentation

Okapi is a lightweight, self-hostable, Sentry-SDK-compatible error tracker. Point an existing Sentry SDK at Okapi — change the DSN, nothing else — and get grouped issues, triage, structured logs, release/regression tracking, alerts to Slack, email and webhooks, and a native MCP server for AI coding agents. Okapi speaks the Sentry ingest wire format; it is not affiliated with Sentry.

The whole product is one Go binary with a React dashboard embedded inside it, backed by a single Postgres database. Today you run it yourself. A hosted cloud version is planned and is not open yet; it will run the same binary, dashboard, and DSN format.

Self-host or cloud

  • Self-host — your Docker Compose stack, your Postgres, your data, on your own infrastructure. A 14-day full-featured trial, no key required. See Self-host vs. cloud if you're deciding between the two.
  • Cloud — a hosted instance, multi-organization and billed per tier, with no infrastructure to run. Cloud is not open for signup yet.

Agent-first, not agent-bolted-on

Okapi ships an MCP server, mounted over HTTP at /mcp on every running instance, on every plan, self-host or cloud — it is never a paid upsell. If you're setting Okapi up so a coding agent can triage your errors, start at MCP & agents.

How these docs are organized

  1. Quickstart — a self-hosted instance running in about five minutes.
  2. Installation — the full self-host install: compose file anatomy, every environment variable, updating, and backups.
  3. SDK setup — setup for 15 language and framework platforms, plus source map uploads.
  4. Issues & logs — grouping, the issue lifecycle, structured logs, releases and regressions.
  5. Performance monitoring — traces, expensive queries, and slow-query and N+1 performance issues.
  6. Views — named sets of projects you read and alert on as one.
  7. Alerts & notifications — team and personal rules, triggers, filters, volume limits, and the in-app inbox.
  8. Notification channels — Slack and webhook destinations, delivery, retries, and caps.
  9. Digests — daily and weekly summaries.
  10. Webhooks — the signed payload and how to verify it.
  11. Quotas & usage — how self-host entitlements and cloud daily quotas work.
  12. Licensing — the self-host trial, activation, coverage, and the migration gate.
  13. MCP & agents — wiring up Claude Code/Desktop and other MCP clients.
  14. Telemetry — exactly what phones home, and how to turn it off.
  15. Self-host vs. cloud — an honest comparison.

These docs describe the current product. A feature that no released self-host version has yet is marked with the note "Not in a released self-host version yet." If something here does not match your instance, the version you run is the source of truth.