Debug everything. Install nothing.

One binary. Exceptions, dumps, emails, profiling, logs — all in one real-time UI. Works with the SDKs you already have. No cloud account. No code changes. No runtime dependencies.

Buggregator v2.0 is a complete rewrite in Go — a single self-contained binary with an embedded SQLite database, web UI, and WebSocket server. No PHP runtime, no RoadRunner, no Centrifugo, no external database.

| | | |---|---| | Server | v2.0.0 | | Frontend | v1.30.0 |

Looking for the PHP version? See the 1.x branch.

Watch our introduction video on YouTube

Quick Start

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 and start debugging. That's it.

Standalone Binary

# Download the latest release
curl -sL https://github.com/buggregator/server/releases/latest/download/buggregator-linux-amd64 -o buggregator
chmod +x buggregator
./buggregator

No Docker? No binary? Use Buggregator Trap — a lightweight PHP CLI alternative.

Key Features

Xhprof Profiler

Watch our intro video about profiler on YouTube.

xhprof

Symfony VarDumper Server

var-dumper

Spatie Ray Debug Tool

ray

Fake SMTP Server

smtp

Sentry Compatibility

sentry

Monolog Server

monolog

Inspector Compatibility

inspector

HTTP Requests Dump Server

Supported Modules

| Module | Type | Transport | Description | |--------|------|-----------|-------------| | Sentry | sentry | HTTP | Error tracking (gzip, envelope format) | | Ray | ray | HTTP | Debug tool for PHP | | VarDumper | var-dump | TCP :9912 | Symfony VarDumper (embedded PHP parser) | | Inspector | inspector | HTTP | APM monitoring | | Monolog | monolog | TCP :9913 | Logging (newline-delimited JSON) | | SMTP | smtp | TCP :1025 | Email capture (RFC822, multipart, attachments) | | SMS | sms | HTTP /sms | SMS gateway capture (41 providers) | | HTTP Dump | http-dump | HTTP | Catch-all HTTP request capture | | Profiler | profiler | HTTP | XHProf profiling (call graph, flame chart, top functions) | | Webhooks | webhooks | — | HTTP POST notifications when events are received |

Configuration

The server works with zero configuration. Optionally, create a buggregator.yaml:

server:
  addr: ":8000"

database:
  driver: sqlite
  dsn: ":memory:"           # or "data.db" for persistence

# Prometheus metrics (optional)
metrics:
  enabled: true
  addr: ":9090"             # separate server, or empty to use main HTTP

tcp:
  smtp:
    addr: ":1025"
  monolog:
    addr: ":9913"
  var-dumper:
    addr: ":9912"

# Authentication (disabled by default)
# Supports: auth0, google, github, keycloak, gitlab, oidc (generic)
auth:
  enabled: true
  provider: auth0
  provider_url: https://your-tenant.us.auth0.com
  client_id: your-client-id
  client_secret: your-client-secret
  callback_url: http://localhost:8000/auth/sso/callback
  scopes: openid,email,profile
  jwt_secret: your-secret-for-signing-tokens

# MCP — AI assistant integration (disabled by default)
mcp:
  enabled: true
  transport: socket              # "socket" or "http"
  socket_path: /tmp/buggregator-mcp.sock

# Enable/disable modules (all enabled by default)
modules:
  sentry: true
  ray: true
  var-dump: true
  inspector: true
  monolog: true
  smtp: true
  sms: true
  http-dump: true
  profiler: true

# Webhooks — HTTP POST notifications on events
webhooks:
  - event: "*"
    url: https://slack.example.com/webhook
    headers:
      Authorization: "Bearer token"
    verify_ssl: false
    retry: true
  - event: sentry
    url: https://pagerduty.example.com/alert

# Pre-defined projects
projects:
  - key: my-app
    name: My Application

Configuration Priority

CLI flags (--http-addr :9000)
Environment variables (HTTP_ADDR=:9000)
Config file (buggregator.yaml)
Defaults

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | HTTP_ADDR | :8000 | HTTP listen address | | DATABASE_DSN | :memory: | SQLite DSN | | SMTP_ADDR | :1025 | SMTP listen address | | MONOLOG_ADDR | :9913 | Monolog TCP address | | VAR_DUMPER_ADDR | :9912 | VarDumper TCP address | | CLIENT_SUPPORTED_EVENTS | all | Comma-separated list of enabled modules | | METRICS_ENABLED | false | Enable Prometheus metrics | | METRICS_ADDR | — | Separate metrics server address | | AUTH_ENABLED | false | Enable OAuth2/OIDC authentication | | AUTH_PROVIDER | oidc | Provider: auth0, google, github, keycloak, gitlab, oidc | | AUTH_PROVIDER_URL | — | OIDC issuer URL | | AUTH_CLIENT_ID | — | OAuth2 client ID | | AUTH_CLIENT_SECRET | — | OAuth2 client secret | | AUTH_CALLBACK_URL | — | OAuth2 callback URL | | AUTH_SCOPES | openid,email,profile | Comma-separated OAuth2 scopes | | AUTH_JWT_SECRET | — | Secret for signing internal JWT tokens | | MCP_ENABLED | false | Enable MCP server | | MCP_TRANSPORT | socket | socket (local) or http (remote) | | MCP_SOCKET_PATH | /tmp/buggregator-mcp.sock | Unix socket path | | MCP_ADDR | :8001 | HTTP listen address for MCP | | MCP_AUTH_TOKEN | — | Bearer token for HTTP MCP transport |

PHP Client Configuration

Laravel / Symfony

# .env
SENTRY_LARAVEL_DSN=http://sentry@localhost:8000/default
RAY_HOST=ray@localhost
RAY_PORT=8000
VAR_DUMPER_SERVER=localhost:9912
LOG_SOCKET_URL=localhost:9913
MAIL_HOST=localhost
MAIL_PORT=1025
INSPECTOR_URL=http://inspector@localhost:8000
INSPECTOR_API_KEY=test
PROFILER_ENDPOINT=http://profiler@localhost:8000
HTTP_DUMP_ENDPOINT=http://http-dump@localhost:8000
SMS_ENDPOINT=http://localhost:8000/sms

MCP (Model Context Protocol)

Buggregator includes a built-in MCP server that lets AI assistants (Claude Code, Cursor, etc.) query and analyze debugging data directly.

AI Assistant --stdio--> buggregator mcp --unix socket--> buggregator (main process)

Setup

Claude Code (~/.claude.json or project settings):

{
  "mcpServers": {
    "buggregator": {
      "command": "./buggregator",
      "args": ["mcp"]
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "buggregator": {
      "command": "./buggregator",
      "args": ["mcp"]
    }
  }
}

Available Tools

| Tool | Description | Key Parameters | |------|-------------|----------------| | events_list | List captured events | type, project, limit (default 20, max 100) | | event_get | Get full event payload | uuid | | event_delete | Delete an event | uuid | | profiler_summary | Profile overview: totals, slowest function, memory hotspot | uuid | | profiler_top | Top functions sorted by metric | uuid, metric, limit | | profiler_call_graph | Filtered call graph with significant paths | uuid, metric, percentage, threshold | | sentry_event | Structured error: exception chain, stack traces, tags | uuid | | vardump_get | Variable value with HTML stripped | uuid |

Building from Source

Prerequisites

Go 1.22+
PHP 8.1+ with Composer (for VarDumper module)
Make

make build          # Full build: downloads frontend, builds PHP parser, compiles binary
make run            # Build and run
make build-cross GOOS=darwin GOARCH=arm64   # Cros

Server

Install / Use

README