In active development · MIT

Free, self-hosted error tracking for your Sentry SDKs.

Free, MIT, no paid tier. Keep your Sentry SDKs, change one line: the DSN.

One container and SQLite. MCP-first, so your agents can triage. Built by Skcript.

Alerts in your pocket: a free, native iOS app with push, Resolve and Mute on the notification, and widgets.

docker run -d -p 8080:8080 -v openfault:/data ghcr.io/openfault/openfault
sentry.client.config.ts
1import * as Sentry from "@sentry/nextjs";
2
3Sentry.init({
4 dsn: "https://<key>@o123.ingest.sentry.io/1",
5 tracesSampleRate: 1.0,
6});
~ — zsh
~❯docker run -d -p 8080:8080 \
-v openfault:/data \
ghcr.io/openfault/openfault
4f1c9a2e7b3d
errors.example.com
IssuesLive
Error: hello from OpenFaultweb · just now
TypeError: Cannot read properties of undefined18web · 2m ago
NoMethodError: undefined method 'amount' for nil7storefront · 14m ago

01 · Drop-in

Keep your SDKs. Change one line.

OpenFault speaks the Sentry envelope protocol. The official Sentry SDKs post to it as they are. No fork, no plugin, no wrapper.

  • Rails
  • Next.js
  • Node
  • Python

Minified stack traces? sentry-cli sourcemaps upload works against it, same flags, same debug IDs.

iOS crashes? Upload dSYMs from an Xcode build phase. Swift frames come back demangled, with file and line.

Not doing Tracing, session replay, profiling. On purpose. OpenFault tracks errors. That is the whole job.

sentry.client.config.ts

Sentry.init({
-  dsn: "https://[email protected]/56",
+  dsn: "https://[email protected]/1",
   tracesSampleRate: 0,
});

02 · Grouping

Grouping that doesn’t split bugs.

Issues are keyed on the shape of the stack: module, file, function. Never line numbers. Add a log line above the crash and the next event still lands in the same issue.

A second key on exception type and message catches refactors that move the stack. Want your own rule? Send a fingerprint. {{ default }} keeps our key in the mix.

order.rb · Order#total

41  def total42    logger.info("total")43    items.sum(&:price)raises44  end
  • #4812orders | order.rb | total2 evt
    evt a1f3order.rb:42eu
    evt 9c07order.rb:43eu

Event 9c07 from order.rb line 43 grouped into issue #4812, 2 events.

03 · MCP

Built for agents. Gated by people.

MCP is built in. Every tool calls the same handler the UI uses, so an agent sees what you see and nothing more.

An agent can list, search and triage. It can’t read the stack or start a fix until a person clicks Approve. Captured data is untrusted: every message, breadcrumb and tag comes back fenced, with a note telling the model not to follow it.

  • list_new_issues
  • search_issues
  • get_issue
  • resolve_issue
  • mute_issue
  • link_fix

Admin tokens add admin tools: create projects and teams, invite members. Any issue reads as Markdown, ready to paste into a prompt.

Claude Code

claude mcp add -t http openfault https://errors.example.com/mcp -H "Authorization: Bearer $OPENFAULT_TOKEN"
Cursor VS Code
Agent

04 · One container

One container. One volume. That’s the stack.

A Rust binary and SQLite. No Redis, no Kafka, no Postgres, no ClickHouse. It runs next to your app on the small VPS you already pay for. IPv4 and IPv6 out of the box.

ssh vps

docker stats

openfault1 container
10 MBidle · limit 100 MB
peak 28 MB

ls /data

openfault.dbSQLiteRetention 90 days
Image
~12 MB
Peak RAM, 10k-event burst
28 MB measured
Default retention
90 days
Backup
/data
Copy the volume, or back up daily to S3 or R2.

05 · Live

Live, on the wall.

Counters, rows and charts update live as errors land. No polling, no refresh.

TV mode is built for the team screen: fullscreen, big numbers, a ticker of the newest issues.

It’s a web page. Open /tv in any browser.

/tv

OpenFault/AcmeLive
Unresolved
Events · 1h
Events · 24h
New issues · 24h
Regressions · 24h
Last hour5-minute buckets
Web App+156%
unresolved events · 24h
dev-16%
unresolved events · 24h

06 · iOS On the App Store

In your pocket.

Pair it in a minute: scan the QR code in Settings → Devices.

Push with Resolve and Mute right on the notification.

Home and lock screen widgets for unresolved counts and the latest issue.

Download on the App Store

errors.example.com/issues
Issues
is:unresolved
ActiveRecord::Deadlocked: Mysql2::Error: Deadlock foundstorefront3 events
Net::ReadTimeout with #<TCPSocket:(closed)>storefront7 events
Error: connect ETIMEDOUT 10.0.3.14:5432api2 events
RangeError: Request timed out after 30000msweb1 event
9:41
Thursday, November 6
9:41
New issue in webnowTypeError: Cannot read properties of undefined (reading 'total')

07 · Teams

Teams and alerts.

It’s for the whole team, not just whoever set it up.

Invites and roles
Owner, admin, member. Group people and projects into teams. Invite by email or send a link. Closed signup by default.
Alerts
On new issues, regressions and spikes. Per person, per project.
Channels
Email, Slack, Discord, or any webhook.

08 · Compare

How it stacks up.

Measured, not promised: 10 MB RSS idle, peak 28 MB in a 10k-event burst across 3 projects (3,000 accepted, 7,000 rate-limited; tests/load.rs) (Apple M5, macOS 27, 2026-11-06).

Full Sentry comparison → · All alternatives →

OpenFaultSentry self-hostedGlitchTipBugsinkTelebugs
LicenseMITFSL (converts to Apache 2.0 after 2 years)MITPolyForm Shield 1.0.0 (source-available, not OSI-approved)Proprietary
Self-host priceFree, MIT, no paid tierFreeFreeFree$299 first year, $99/yr renewal
Hosted planNoneDeveloper free (1 user, 5k errors); Team $26/mo annual, $29 monthlyFree up to 1k events/mo; $15/mo small planFree 15K-event evaluation plan; paid from €16/mo (checked 2026-11-09)Managed $99/mo after a 14-day trial (checked 2026-11-09)
Containers to run1—App + Postgres11
DatabaseSQLitePostgres, ClickHouse, Kafka, RedisPostgresSQLite supportedSQLite
Minimum RAMPeak 28 MB in a 10k-event burst (measured)16 GB + 16 GB swap256 MB minimum, 512 MB recommended—1 GB
RuntimeRust + SQLitePython, Kafka, ClickHouse, Postgres, RedisPython (Django)PythonRuby on Rails
Sentry SDK compatibleYesYesYesYesYes
Source mapsYes, via sentry-cliYesYes, via file uploadYes, via sentry-cliYes
iOS crash symbolicationYes, dSYM upload + Swift demanglingYes———
Live updates and TV modeYes, SSE————
MCP serverBuilt in, approval-gatedSeparate server——Built in (per telebugs.com, checked 2026-11-20)
iOS appWidgets, push, QR pairing (on the App Store)————

Verified 2026-11-09. A dash means we haven’t checked. Sources: Sentry self-hosted, Sentry pricing, GlitchTip, Bugsink, Telebugs.

09 · Install

Running in a minute.

One command, no config. The secret key is generated into /data on first boot.

  1. Start the container.

    docker run -d -p 8080:8080 -v openfault:/data ghcr.io/openfault/openfault
  2. Open http://localhost:8080. The setup wizard creates your admin account and first project.

  3. Copy the project’s DSN into your Sentry SDK config. Deploy. Watch the first error come in.

  4. No app handy? Send your first error by hand. Use the public key from the project’s DSN.

    curl http://localhost:8080/api/1/envelope/ -H 'X-Sentry-Auth: Sentry sentry_key=<public-key>' --data-binary $'{}\n{"type":"event"}\n{"message":"hello from OpenFault","level":"error"}\n'

10 · FAQ

Questions.

Is it really drop-in?

For errors, yes. OpenFault accepts the same envelope endpoint the Sentry SDKs already post to. Point the DSN at your server and events land. Items we don’t handle, like transactions, are dropped, not rejected, so your app never notices.

Is there a mobile app for error alerts?

Yes. The OpenFault iOS app is free on the App Store, native Swift, and MIT-licensed on GitHub. Pair it by scanning the QR code in Settings → Devices. Pushes arrive with Resolve and Mute right on the notification, and home and lock screen widgets show unresolved counts and the latest issue. Push is off until you opt in: use our hosted relay, or run your own relay and build the app with your own Apple account. The app needs a running OpenFault server.

Does it work with AI coding agents?

Yes. OpenFault is an MCP server. Claude Code, Cursor or any client that speaks Streamable HTTP can list, search and triage issues, and can set up a fresh instance end to end. A person clicks Approve for fix before an agent gets an issue’s stack frames, breadcrumbs and request data; nothing starts on its own. Event data is wrapped as untrusted so the agent does not follow instructions hidden in it. Give agents a read token unless you want them to resolve or mute issues. Once an issue is approved, an agent can attach the pull request that fixes it.

What about performance tracing?

Not planned. No tracing, no session replay, no profiling. If you need those, keep a tool for them and send errors here. Doing one job is how this stays one small container.

Can I migrate from Sentry?

Change the DSN in each app and deploy. New errors flow into OpenFault from then on. We don’t import history, so keep Sentry around read-only until you stop needing the old issues.

How is data retained?

Events are kept for 90 days by default, set per project. Within an issue we keep the first 25 events of each hour, then 1 in 20, and the counters always count. A noisy bug can’t fill your disk. Everything lives in /data.

Is it production ready?

Not yet. OpenFault is in active development and nothing here is ready for production. Follow the repo on GitHub to see when the first release ships.

Keyboard shortcuts

c
Copy the install command
t
Toggle theme
g d
Open the docs
?
Show this list