Okapi
Start 14-day trial

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, Slack + email alerts, 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. Run it yourself, or use the hosted version at useokapi.app. Same binary, same dashboard, same DSN format either way.

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 — the hosted useokapi.app instance. Multi-organization, billed per tier, no infrastructure to run.

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 — pointing Sentry SDKs (JS, Node, PHP, Python, Go, Ruby) at Okapi, plus source map uploads.
  4. Issues & logs — grouping, the issue lifecycle, structured logs, releases and regressions.
  5. Alerts — Slack and email alert rules.
  6. Quotas & usage — how self-host entitlements and cloud daily quotas work.
  7. Licensing — the self-host trial, activation, coverage, and the migration gate.
  8. MCP & agents — wiring up Claude Code/Desktop and other MCP clients.
  9. Telemetry — exactly what phones home, and how to turn it off.
  10. Self-host vs. cloud — an honest comparison.

If something here doesn't match what you see in your instance, the source of truth is always the version you're running — these docs track the current release.