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
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:latestOpen http://127.0.0.1:8000 and start debugging. That's it.
# Download the latest release
curl -sL https://github.com/buggregator/server/releases/latest/download/buggregator-linux-amd64 -o buggregator
chmod +x buggregator
./buggregatorNo Docker? No binary? Use Buggregator Trap — a lightweight PHP CLI alternative.
Watch our intro video about profiler on YouTube.
| 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 |
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- CLI flags (
--http-addr :9000) - Environment variables (
HTTP_ADDR=:9000) - Config file (
buggregator.yaml) - Defaults
| 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 |
# .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/smsBuggregator 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)
Claude Code (~/.claude.json or project settings):
{
"mcpServers": {
"buggregator": {
"command": "./buggregator",
"args": ["mcp"]
}
}
}Cursor (.cursor/mcp.json):
{
"mcpServers": {
"buggregator": {
"command": "./buggregator",
"args": ["mcp"]
}
}
}| 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 |
- 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 # Cross-compileSee the documentation for detailed installation and usage instructions.
We enthusiastically invite you to contribute to Buggregator Server! Whether you've uncovered a bug, have innovative feature suggestions, or wish to contribute in any other capacity, we warmly welcome your participation. Simply open an issue or submit a pull request on our GitHub repository to get started.
Read more about how to contribute here.
Buggregator is open-sourced software licensed under the MIT License.