Skip to content
Back to search

server

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, Xdebug in the browser, MCP for AI agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/buggregator/server with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/buggregator/server'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/buggregator--server/badge.svg)](/listings/buggregator--server)

HTML

<a href="/listings/buggregator--server"><img src="/api/listings/buggregator--server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 168 lines · 2 findings marked
  1. # Buggregator — one local server for everything your app sends while you develop
  2. [![Release](https://img.shields.io/github/v/release/buggregator/server)](https://github.com/buggregator/server/releases/latest)
  3. [![CI](https://github.com/buggregator/server/actions/workflows/ci.yml/badge.svg)](https://github.com/buggregator/server/actions/workflows/ci.yml)
  4. [![Docker pulls](https://img.shields.io/docker/pulls/butschster/buggregator.svg)](https://hub.docker.com/r/butschster/buggregator)
  5. <a href="https://discord.gg/vDsCD3EKUB"><img src="https://img.shields.io/badge/discord-chat-magenta.svg" alt="Discord"></a>
  6. [![Follow on X](https://img.shields.io/badge/follow-%40buggregator-black?logo=x)](https://x.com/buggregator)
  7. **One ~40 MB binary catches the errors, dumps, emails, logs, profiles and HTTP requests your app sends in development — through the SDKs and protocols you already use. No account, no cloud, no Buggregator package in your app.**
  8. - **Errors and traces** from your Sentry SDK — exceptions, transactions, logs, metrics
  9. - **Dumps** from Symfony VarDumper and Spatie Ray
  10. - **Emails** from a fake SMTP server, with an API to wait for a message and pull links or codes in E2E tests
  11. - **Logs** from Monolog
  12. - **Profiles** from XHProf — call graph, flame chart, top functions
  13. - **HTTP**: catch any request, proxy outgoing calls, or answer with a **mock server** (rules or an OpenAPI spec)
  14. - **Xdebug in the browser**: pause, step, read variables — with or without an IDE
  15. - **AI agents** read all of it over MCP
  16. Mail, HTTP dumps, the proxy, mocks and MCP work with any language. Sentry errors, traces and logs are tested with the official SDKs for PHP, JavaScript (browser and Node.js), Python and Go.
  17. ## Run it in 30 seconds
  18. **Binary** (Linux, macOS, Windows; x86-64 and ARM):
  19. ```bash
  20. curl -fsSL https://raw.githubusercontent.com/buggregator/server/master/scripts/install.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 27 on GitHub
  21. buggregator
  22. ```
  23. Windows (PowerShell):
  24. ```powershell
  25. irm https://raw.githubusercontent.com/buggregator/server/master/scripts/install.ps1 | iex
  26. ```
  27. The script picks the file for your system, checks its checksum and installs it without `sudo`. On Linux and macOS it installs into `~/.local/bin`; if that folder is not on your `PATH`, the script says so — then run `~/.local/bin/buggregator`. On Windows it installs into `%LOCALAPPDATA%\Programs\buggregator` and prints the command to start it. By default the binary listens on all network interfaces; to keep it on your machine only, see [Listen only on this machine](https://docs.buggregator.dev/install.html).
  28. **Docker:**
  29. ```bash
  30. docker run --pull always \
  31. -p 127.0.0.1:8000:8000 \
  32. -p 127.0.0.1:1025:1025 \
  33. -p 127.0.0.1:9912:9912 \
  34. -p 127.0.0.1:9913:9913 \
  35. ghcr.io/buggregator/server:latest
  36. ```
  37. Open http://127.0.0.1:8000. The UI stays empty until your app sends something.
  38. Events live in memory and are gone after a restart. To keep them: `buggregator -db ./buggregator.db`.
  39. ## Point your app at it
  40. Change addresses, not code. Laravel / Symfony `.env`:
  41. ```env
  42. SENTRY_LARAVEL_DSN=http://sentry@127.0.0.1:8000/1
  43. MAIL_HOST=127.0.0.1
  44. MAIL_PORT=1025
  45. VAR_DUMPER_SERVER=127.0.0.1:9912
  46. LOG_SOCKET_URL=127.0.0.1:9913
  47. RAY_HOST=ray@127.0.0.1
  48. RAY_PORT=8000
  49. PROFILER_ENDPOINT=http://profiler@127.0.0.1:8000
  50. INSPECTOR_URL=http://inspector@127.0.0.1:8000
  51. INSPECTOR_API_KEY=test
  52. HTTP_DUMP_ENDPOINT=http://http-dump@127.0.0.1:8000
  53. ```
  54. Any other stack: send mail to SMTP `127.0.0.1:1025`, send a POST or PUT to `http://127.0.0.1:8000`, or any method to `http://http-dump@127.0.0.1:8000`, to see it as a dump, and put mock rules under `http://127.0.0.1:8000/mock/`.
  55. Sentry from other languages — same DSN:
  56. ```js
  57. // JavaScript, browser or Node.js
  58. Sentry.init({ dsn: "http://sentry@127.0.0.1:8000/1", tracesSampleRate: 1.0, enableLogs: true });
  59. // Browser page-load traces: also pass integrations: [Sentry.browserTracingIntegration()]
  60. ```
  61. ```python
  62. # Python
  63. sentry_sdk.init(dsn="http://sentry@127.0.0.1:8000/1", traces_sample_rate=1.0, enable_logs=True)
  64. ```
  65. ```go
  66. // Go
  67. sentry.Init(sentry.ClientOptions{Dsn: "http://sentry@127.0.0.1:8000/1", EnableTracing: true, TracesSampleRate: 1.0})
  68. defer sentry.Flush(2 * time.Second) // short programs: send events before exit
  69. ```
  70. More setups (Spiral, WordPress, Magento, Docker Compose, Kubernetes): [Getting started](https://docs.buggregator.dev/getting-started.html).
  71. | Port | What listens |
  72. |------|--------------|
  73. | `8000` | Web UI, HTTP events (Sentry, Ray, Inspector, XHProf, HTTP dumps, SMS, Xdebug traces), mock server |
  74. | `1025` | SMTP |
  75. | `9912` | VarDumper (not on Windows) |
  76. | `9913` | Monolog |
  77. | `8080` | HTTP proxy |
  78. ## What it catches
  79. | | Send from | Docs |
  80. |---|---|---|
  81. | Sentry: exceptions, traces, logs, metrics | Sentry SDK (DSN) | [Sentry](https://docs.buggregator.dev/config/sentry.html) |
  82. | Emails | any SMTP client | [SMTP](https://docs.buggregator.dev/config/smtp.html) |
  83. | Dumps | Symfony VarDumper, Spatie Ray | [VarDumper](https://docs.buggregator.dev/config/var-dumper.html), [Ray](https://docs.buggregator.dev/config/ray.html) |
  84. | Logs | Monolog (JSON over TCP) | [Monolog](https://docs.buggregator.dev/config/monolog.html) |
  85. | Profiles | XHProf | [XHProf](https://docs.buggregator.dev/config/xhprof.html) |
  86. | APM transactions | Inspector | [Inspector](https://docs.buggregator.dev/config/inspector.html) |
  87. | Any HTTP request | curl, webhooks, your app | [HTTP dumps](https://docs.buggregator.dev/config/http-dumps.html) |
  88. | Outgoing HTTP calls | HTTP proxy on `:8080` | [HTTP proxy](https://docs.buggregator.dev/config/http-proxy.html) |
  89. | SMS | requests in the format of 42 SMS providers (Twilio, Vonage, Infobip…) | [SMS](https://docs.buggregator.dev/config/sms.html) |
  90. | Xdebug function traces | `curl` upload of a trace file | [Xdebug traces](https://docs.buggregator.dev/config/xdebug-trace.html) |
  91. And around it:
  92. - **Mock server.** Requests to `/mock/...` get the response of the first matching rule: method + path → status, headers, body, delay. Rules from the UI, the API, `buggregator.yaml`, Go templates for dynamic bodies, or one rule per operation from an OpenAPI 3.x spec. [Docs](https://docs.buggregator.dev/config/mock-server.html)
  93. - **Email testing API.** `GET /api/smtp/messages/wait` holds the request until the email your test expects arrives; `/links` and `/codes` pull the confirmation link or the one-time code out of it. [Docs](https://docs.buggregator.dev/config/smtp.html)
  94. - **Xdebug without an IDE (off by default).** Buggregator sits between Xdebug and your IDE. With no IDE attached, a script pauses at `xdebug_break()` or a saved breakpoint, and you continue or step from the browser. [Docs](https://docs.buggregator.dev/config/xdebug.html)
  95. - **Projects.** One instance for several apps: each event goes to the project named in its DSN, header or SMTP username. [Docs](https://docs.buggregator.dev/config/projects.html)
  96. - **Webhooks, SSO, Prometheus metrics** for shared or CI setups. [Webhooks](https://docs.buggregator.dev/config/webhooks.html) · [SSO](https://docs.buggregator.dev/config/sso.html) · [Metrics](https://docs.buggregator.dev/config/metrics.html)
  97. ## For AI agents (MCP)
  98. Buggregator has a built-in MCP server. Claude Code, Cursor or any MCP client can list events, read a Sentry error with its stack trace, read dumps and profiles, find the slow calls in an Xdebug trace, and create mock rules. With the Xdebug proxy on, the agent can also set breakpoints and step through PHP code.
  99. ```bash
  100. MCP_ENABLED=true buggregator
  101. claude mcp add buggregator -- buggregator mcp
  102. ```
  103. 23 tools by default; 35 with the Xdebug proxy, 36 with `allow_eval`. On Windows or in Docker, use the HTTP transport. Setup for other clients: [MCP](https://docs.buggregator.dev/config/mcp.html). Want an agent to install and set it up for you? Give it [this page](https://docs.buggregator.dev/agent-setup.html).
  104. ## Configuration
  105. Zero config to start. Every setting is a flag, an environment variable or a line in `buggregator.yaml` (flags win over variables, variables over the file). Annotated example: [`buggregator.yaml.example`](buggregator.yaml.example). All options: [Server configuration](https://docs.buggregator.dev/config/server.html).
  106. ## Build from source
  107. Needs Go 1.26+, PHP 8.1+ with Composer (for the VarDumper parser) and Make.
  108. ```bash
  109. make build # downloads the UI, builds the PHP parser, compiles the binary
  110. make run
  111. make build-cross GOOS=darwin GOARCH=arm64
  112. ```
  113. ## Like it?
  114. **If Buggregator replaced a tool or two on your machine, [give it a star](https://github.com/buggregator/server/stargazers) — that is how other developers find it.**
  115. - Website: [buggregator.dev](https://buggregator.dev)
  116. - Docs: [docs.buggregator.dev](https://docs.buggregator.dev)
  117. - Chat: [Discord](https://discord.gg/vDsCD3EKUB)
  118. - Support the author: [Patreon](https://patreon.com/butschster)
  119. - No binary or Docker? [Buggregator Trap](https://docs.buggregator.dev/trap/what-is-trap.html) is a small PHP CLI alternative.
  120. - Buggregator 1.x (PHP) lives on the [1.x branch](https://github.com/buggregator/server/tree/1.x); new work happens here.
  121. ## Contributing
  122. Found a bug or have an idea? Open an issue or a pull request. How to set up the project: [Contributing](https://docs.buggregator.dev/contributing.html).
  123. ## License
  124. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.