Skip to content
@buggregator

Buggregator

One local debugging server: errors, dumps, emails, logs, profiles and HTTP from your app in development. One binary, MIT, no cloud.

One local server for everything your app sends while you develop

Errors, dumps, emails, logs, profiles and HTTP requests — in one window on your machine.
Built for PHP. Node.js, browser JavaScript, Python, Go and Java send errors through their Sentry SDK; mail and HTTP work from any language.
Free, MIT, no account, no cloud.

Latest release Stars Docker pulls Discord Follow on X

Buggregator in 30 seconds: events arrive, then an exception, an email, dumps and a profile are opened

Run it

# Linux, macOS — one binary, no sudo
curl -fsSL https://raw.githubusercontent.com/buggregator/server/master/scripts/install.sh | sh
buggregator
# Windows (PowerShell)
irm https://raw.githubusercontent.com/buggregator/server/master/scripts/install.ps1 | iex
# Docker
docker run --pull always -p 127.0.0.1:8000:8000 -p 127.0.0.1:1025:1025 \
  -p 127.0.0.1:9912:9912 -p 127.0.0.1:9913:9913 ghcr.io/buggregator/server:latest

Open http://127.0.0.1:8000, then point your app at it: change addresses in .env, not code. Getting started →

What it replaces on your machine

Instead of Buggregator catches Sent from
A cloud Sentry project for local errors Exceptions, traces, logs, metrics Sentry SDK (DSN)
Mailpit, MailHog, Mailtrap Emails with HTML preview, plus an API for E2E tests Any SMTP client
The Ray app, for viewing ray() calls Dumps, queries, models, jobs Symfony VarDumper, Spatie Ray
A log viewer Logs, live Monolog
An XHProf UI Call graph, flame chart, top functions XHProf
RequestBin, a hand-written stub API Any HTTP request, outgoing calls via a proxy, a mock server from rules or an OpenAPI spec curl, webhooks, your app

Also: SMS in the format of 42 providers, Xdebug in the browser, and a built-in MCP server so Claude Code, Cursor or any MCP client can read your errors, dumps and profiles.

For a team or CI: Kubernetes-ready — helm install buggregator oci://ghcr.io/buggregator/helm-chart/buggregator (one replica, data on a persistent volume, non-root) — plus SSO for the UI, Prometheus metrics, an OpenAPI spec of the API and a CI example.

A Sentry exception with its stack trace An order confirmation email in the HTML preview
VarDumper dumps: a boolean, a number, a string and an SQL query A profiler call graph, slow functions in red

Repositories

server The server: one Go binary or a Docker image. Start here.
trap A small PHP CLI alternative: composer require --dev buggregator/trap, no Docker or binary.
frontend The web UI (Vue 3, TypeScript), built into every server release.
docs The documentation at docs.buggregator.dev. Fixes welcome.
helm-chart The official Helm chart: one helm install, data on a persistent volume, non-root.
phpstorm-plugin Buggregator in PhpStorm.

Get involved

buggregator.dev · docs.buggregator.dev

Pinned Loading

  1. server server Public

    One local debugging server, one binary: catches errors, dumps, emails, logs, profiles and HTTP from your app in development. Speaks Sentry, Ray, VarDumper, Monolog, SMTP, XHProf. Mock server, Xdebu…

    Go 1.1k 44

  2. frontend frontend Public

    Buggregator UI

    TypeScript 18 17

  3. trap trap Public

    Enough dumping. Let's trap! A local debug server and dump functions for PHP: dumps, logs, Sentry, emails, OpenTelemetry traces and profiles from XHProf, Xdebug, Excimer, SPX and pprof.

    PHP 276 16

  4. docs docs Public

    Buggregator official documentation

    TypeScript 8 9

  5. phpstorm-plugin phpstorm-plugin Public

    34 3

Repositories

Showing 10 of 19 repositories

Top languages

Loading…

Most used topics

Loading…