whatisgithub

What is pocketsentry?

apvcode/pocketsentry — explained in plain English

Analysis updated 2026-05-18

14HTMLAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

PocketSentry is a single 18MB binary that replaces the heavy self-hosted Sentry error-tracking stack, speaking the same protocol so existing Sentry SDKs connect with no code changes.

Mindmap

mindmap
  root((PocketSentry))
    What it does
      Error tracking server
      Sentry protocol compatible
      Single binary
    Tech stack
      Go
      SQLite
      No CGO
    Use cases
      Replace self hosted Sentry
      Monitor JS Python Go apps
      Telegram Discord alerts
    Audience
      Developers
      Small teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Self-host error tracking without running 40+ Docker containers or 16GB of RAM.

USE CASE 2

Point an existing Sentry SDK (Python, JavaScript, Go) at PocketSentry by just changing the DSN.

USE CASE 3

Get Telegram or Discord alerts the moment a new unique error appears in your app.

What is it built with?

GoSQLiteDocker

How does it compare?

apvcode/pocketsentry1tdspw-26/front-aula-08-1sem1tdspy-26/front-1sem-aula-03
Stars141414
LanguageHTMLHTMLHTML
Setup difficultyeasyeasyeasy
Complexity2/51/51/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Just run the single binary and point your Sentry SDK's DSN at it.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

PocketSentry is a lightweight alternative to self-hosted Sentry, the popular error tracking service. Sentry's official self-hosted version requires running more than 40 Docker containers, consumes at least 16 GB of RAM, and depends on a stack of infrastructure components including Kafka, Redis, ClickHouse, and PostgreSQL. PocketSentry replaces all of that with a single executable file about 18 megabytes in size. The key design choice is compatibility. PocketSentry speaks the same network protocol as Sentry's servers, so existing Sentry SDKs for Python, JavaScript, Go, and other languages connect to it with no code changes. The only configuration needed is changing the DSN, which is the address and project key your application uses to report errors, to point at the local PocketSentry server instead of Sentry's cloud. Data is stored in a SQLite file on disk, which means no separate database to install or maintain. The binary is written in Go without CGO, meaning it has no dependency on system C libraries and can run as-is on Linux, including inside a Docker container if preferred. A built-in dashboard shows incoming errors in near real time, refreshing every two seconds. Errors are automatically grouped by project, message text, and severity level, with a counter showing how many times each unique error has been seen. Duplicate events do not each get their own entry. Beyond basic error capture, PocketSentry includes: detailed stack traces with syntax highlighting, breadcrumbs showing the sequence of user actions before an error occurred, JavaScript source map support for unminifying browser error locations, performance monitoring that tracks slow requests and displays a waterfall view of nested operations, release tracking to associate errors with specific versions of an application, webhook notifications to Telegram or Discord when new unique errors appear, a Telegram bot that lets team members resolve errors without opening the dashboard, and a retention policy that deletes old events automatically. The dashboard is protected by optional username and password. The error ingestion endpoint is unauthenticated by design, matching Sentry's model. PocketSentry is MIT licensed and the full README is longer than what was shown.

Copy-paste prompts

Prompt 1
How do I switch my app's Sentry SDK to point at a self-hosted PocketSentry server instead of Sentry cloud?
Prompt 2
Write a systemd unit file to run the PocketSentry binary as a background service on Linux.
Prompt 3
Set up a webhook so PocketSentry notifies a Discord channel when a new unique error is captured.
Prompt 4
Explain how PocketSentry groups duplicate error events by project, message, and severity.

Frequently asked questions

What is pocketsentry?

PocketSentry is a single 18MB binary that replaces the heavy self-hosted Sentry error-tracking stack, speaking the same protocol so existing Sentry SDKs connect with no code changes.

What language is pocketsentry written in?

Mainly HTML. The stack also includes Go, SQLite, Docker.

What license does pocketsentry use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is pocketsentry to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pocketsentry for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.