Epure

Epure is exception-only error monitoring for self-hosters. Keep your official Sentry SDKs. Change the DSN. When production throws, you get a grouped issue and a stack you can read.

• Official Sentry SDK ingest (envelope + store). Docs
• Grouped issues, breadcrumbs, JS/TS sourcemaps. Quickstart
• Spike valve for infinite loops. Concepts
• Keyboard triage (j / k / e / i) + Markdown export for LLMs
• Alerts, webhooks, releases, regressions
• Multi-project orgs, DSN rotate/revoke, RBAC
• Two containers: Rust binary + PostgreSQL 16 with RLS. Self-host
• Dashboard

2 containers · ~50 MiB idle · ~10 s to first issue · measured 2026-09-20 on Docker Desktop (re-verify on your hardware).

Watch "releases" of this repo to get notified of major updates.

CI and multi-arch image builds run on GitHub Actions (ci.yml, image.yml). Published images: ghcr.io/epure-sh/epure.

Documentation

Full documentation: epure.sh/docs

• Quickstart — first issue on a laptop
• Self-hosting — production install, TLS, backups
• Configuration — env vars and overlays
• Platforms — SDK matrix and honest gaps
• Concepts — DSN, issue, spike valve
• Ingest API — envelope / store reference
• Contributing — build, test, PR

Website: epure.sh · Self-host landing: epure.sh/selfhost

Community & Support

• GitHub Discussions. Best for: setup questions and DSN wiring.
• GitHub Issues. Best for: bugs and SDK / protocol gaps (use a template).
• SECURITY.md. Best for: vulnerabilities · security@news.epure.sh
• Email support · support@news.epure.sh. Best for: Cloud / commercial questions.
• CODE_OF_CONDUCT.md. Conduct · conduct@news.epure.sh

Get started

Docker Compose v2. No .env file. No configure step.

git clone https://github.com/epure-sh/epure.git && cd epure
docker compose up
curl -sS http://localhost:8080/health   # → {"status":"ok"}

Open http://localhost:8080 → register → name a project → copy the DSN → point your SDK.

cp .env.example .env   # edit EPURE_PORT=3000
docker compose up

import * as Sentry from "@sentry/browser";

Sentry.init({
  dsn: "http://{public_key}@localhost:8080/{project_id}",
  tracesSampleRate: 0,
  replaysSessionSampleRate: 0,
  replaysOnErrorSampleRate: 0,
  profilesSampleRate: 0,
});

No @epure/* package. Zero the extra product lines so transactions, replay, and profiles are discarded without surprise. Walkthrough: epure.sh/docs/get-started/quickstart. Production: epure.sh/docs/self-hosting/installation.

./scripts/seed-dev.sh
# login: dev@epure.local / devpassword

How it works

Epure is a small stack for one job: production exceptions → grouped issues → calm triage. It is not a 1-to-1 mapping of Sentry. If the SDK sends transactions, replay, or profiles, the HTTP request is accepted and those items are dropped.

Architecture

Self-host with Docker Compose (two containers). You can also use managed hosting.

graph TD
  SDK[Sentry SDKs] -->|POST envelope or store| EPURE[epure :8080]
  Browser[Browser dashboard] -->|session API| EPURE
  EPURE -->|SQLx async worker| PG[(PostgreSQL 16)]
  EPURE -->|rust-embed SPA| Browser

Plain text: SDKs and the dashboard hit the same Rust process. Host port is EPURE_PORT (default 8080); the process still binds 8080 inside the container. Persistence is PostgreSQL 16 only. No Redis. No Kafka. No separate worker container.

• Ingest gateway — DSN auth, 2 MB body cap, spike valve, Tokio mpsc, returns 202 before persist.
• Spike valve — per-fingerprint token bucket (~100/min). Over limit: counter bumps, duplicate bodies drop. Separate project cap: 5000 events/hour.
• Worker — demangle JS/TS sourcemaps, scrub PII, group by fingerprint, micro-batch INSERT.
• PostgreSQL 16 — issues, events, releases, sessions. Dashboard queries use RLS (app.current_org_id).
• Dashboard — React SPA embedded via rust-embed. Keyboard-first Issues UI.

Ingest path (plain text): SDK → DSN check → spike valve → enqueue → 202 → worker demangle/scrub/group → Postgres.

SDK clients

Keep the official Sentry clients. Epure is the destination.

Full matrix and init snippets: epure.sh/docs/platforms. Wire contract in-repo: docs/ingest.openapi.yaml.

Out of scope (Phase 1)

Distributed tracing · session replay · continuous profiling · generic log ingest · iOS/Android symbolication · Redis / Kafka / ClickHouse on the path.

Apache 2.0 · no ee/ split · CHANGELOG · CONTRIBUTING

Managed hosting: Epure Cloud — Pro $24/mo · Plus $79/mo. Flat pricing, no per-event overage. epure.sh