{"id":26452957,"url":"https://github.com/buggregator/server","last_synced_at":"2026-05-13T08:10:37.379Z","repository":{"id":64854230,"uuid":"490708696","full_name":"buggregator/server","owner":"buggregator","description":"Buggregator is a lightweight, standalone server that offers a range of debugging features for PHP applications.","archived":false,"fork":false,"pushed_at":"2026-03-26T23:07:00.000Z","size":2177,"stargazers_count":985,"open_issues_count":47,"forks_count":34,"subscribers_count":9,"default_branch":"master","last_synced_at":"2026-03-27T08:20:46.309Z","etag":null,"topics":["bugregator","debugging","hacktoberfest","http-dump","laravel","php","ray","sentry","smtp","smtp-server","symfony","xhprof","xhprof-ui"],"latest_commit_sha":null,"homepage":"https://buggregator.dev/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/buggregator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"patreon":"butschster"}},"created_at":"2022-05-10T13:27:47.000Z","updated_at":"2026-03-26T23:55:33.000Z","dependencies_parsed_at":"2023-02-02T21:46:56.337Z","dependency_job_id":"a7f2adda-5ea7-4459-8103-e7a27eaacfa6","html_url":"https://github.com/buggregator/server","commit_stats":null,"previous_names":["buggregator/spiral-app"],"tags_count":73,"template":false,"template_full_name":null,"purl":"pkg:github/buggregator/server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buggregator%2Fserver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buggregator%2Fserver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buggregator%2Fserver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buggregator%2Fserver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/buggregator","download_url":"https://codeload.github.com/buggregator/server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/buggregator%2Fserver/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31309137,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bugregator","debugging","hacktoberfest","http-dump","laravel","php","ray","sentry","smtp","smtp-server","symfony","xhprof","xhprof-ui"],"created_at":"2025-03-18T18:40:29.272Z","updated_at":"2026-05-13T08:10:37.372Z","avatar_url":"https://github.com/buggregator.png","language":"PHP","funding_links":["https://patreon.com/butschster"],"categories":[],"sub_categories":[],"readme":"# Debug everything. Install nothing.\n\n\u003ca href=\"https://discord.gg/vDsCD3EKUB\"\u003e\u003cimg src=\"https://img.shields.io/badge/discord-chat-magenta.svg\"\u003e\u003c/a\u003e\n[![Twitter](https://img.shields.io/badge/twitter-Follow-blue)](https://twitter.com/buggregator)\n[![Support me on Patreon](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Dbutschster%26type%3Dpatrons\u0026style=flat)](https://patreon.com/butschster)\n[![CI](https://github.com/buggregator/server/actions/workflows/ci.yml/badge.svg)](https://github.com/buggregator/server/actions/workflows/ci.yml)\n[![Downloads](https://img.shields.io/docker/pulls/butschster/buggregator.svg)](https://hub.docker.com/repository/docker/butschster/buggregator)\n[![SSL Certificate](https://crt.guru/badge/a0203209-c149-47ee-adbf-a4cf6465b421/shield.svg)](https://crt.guru/badge/a0203209-c149-47ee-adbf-a4cf6465b421)\n\n\u003ca href=\"https://www.producthunt.com/posts/buggregator?embed=true\u0026utm_source=badge-featured\u0026utm_medium=badge\u0026utm_souce=badge-buggregator\" target=\"_blank\"\u003e\u003cimg src=\"https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=478631\u0026theme=light\" alt=\"Buggregator - The\u0026#0032;Ultimate\u0026#0032;Debugging\u0026#0032;Server\u0026#0032;for\u0026#0032;PHP | Product Hunt\" style=\"width: 250px; height: 54px;\" width=\"250\" height=\"54\" /\u003e\u003c/a\u003e\n\n**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.**\n\nBuggregator 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.\n\n| | |\n|---|---|\n| **Server** | `v2.0.0` |\n| **Frontend** | `v1.30.0` |\n\n\u003e Looking for the PHP version? See the [1.x branch](https://github.com/buggregator/server/tree/1.x).\n\nWatch our introduction video on [YouTube](https://www.youtube.com/watch?v=yKWbuw8xN_c)\n\n## Quick Start\n\n```bash\ndocker run --pull always \\\n  -p 127.0.0.1:8000:8000 \\\n  -p 127.0.0.1:1025:1025 \\\n  -p 127.0.0.1:9912:9912 \\\n  -p 127.0.0.1:9913:9913 \\\n  ghcr.io/buggregator/server:latest\n```\n\nOpen http://127.0.0.1:8000 and start debugging. That's it.\n\n### Standalone Binary\n\n```bash\n# Download the latest release\ncurl -sL https://github.com/buggregator/server/releases/latest/download/buggregator-linux-amd64 -o buggregator\nchmod +x buggregator\n./buggregator\n```\n\n\u003e No Docker? No binary? Use [Buggregator Trap](https://docs.buggregator.dev/trap/what-is-trap.html) — a lightweight PHP CLI alternative.\n\n## Key Features\n\n### [Xhprof Profiler](https://docs.buggregator.dev/config/xhprof.html)\n\nWatch our intro video about profiler on [YouTube](https://www.youtube.com/watch?v=2QbgjIVnz78\u0026pp=ygULYnVnZ3JlZ2F0b3I%3D).\n\n![xhprof](https://github.com/buggregator/server/assets/773481/d69e1158-599d-4546-96a9-40a42cb060f4)\n\n### [Symfony VarDumper Server](https://docs.buggregator.dev/config/var-dumper.html)\n\n![var-dumper](https://github.com/buggregator/server/assets/773481/b77fa867-0a8e-431a-9126-f69959dc18f4)\n\n### [Spatie Ray Debug Tool](https://docs.buggregator.dev/config/ray.html)\n\n![ray](https://github.com/buggregator/server/assets/773481/168b27f7-75b1-4837-b0a1-37146d5b8b52)\n\n### [Fake SMTP Server](https://docs.buggregator.dev/config/smtp.html)\n\n![smtp](https://github.com/buggregator/server/assets/773481/8dd60ddf-c8d8-4a26-a8c0-b05052414a5f)\n\n### [Sentry Compatibility](https://docs.buggregator.dev/config/sentry.html)\n\n![sentry](https://github.com/buggregator/server/assets/773481/e979fda5-54c8-42cc-8224-a1c5d828569a)\n\n### [Monolog Server](https://docs.buggregator.dev/config/monolog.html)\n\n![monolog](https://github.com/buggregator/server/assets/773481/21919110-fd4d-490d-a78e-41242d329885)\n\n### [Inspector Compatibility](https://docs.buggregator.dev/config/inspector.html)\n\n![inspector](https://github.com/buggregator/server/assets/773481/ab002ecf-e1dc-4433-90d4-0e42ff8c0ab3)\n\n### [HTTP Requests Dump Server](https://docs.buggregator.dev/config/http-dumps.html)\n\n![http dumps](https://github.com/buggregator/server/assets/773481/fc823390-b490-4bbb-a787-44471eca9fb6)\n\n## Supported Modules\n\n| Module | Type | Transport | Description |\n|--------|------|-----------|-------------|\n| Sentry | `sentry` | HTTP | Error tracking (gzip, envelope format) |\n| Ray | `ray` | HTTP | Debug tool for PHP |\n| VarDumper | `var-dump` | TCP :9912 | Symfony VarDumper (embedded PHP parser) |\n| Inspector | `inspector` | HTTP | APM monitoring |\n| Monolog | `monolog` | TCP :9913 | Logging (newline-delimited JSON) |\n| SMTP | `smtp` | TCP :1025 | Email capture (RFC822, multipart, attachments) |\n| SMS | `sms` | HTTP `/sms` | SMS gateway capture (41 providers) |\n| HTTP Dump | `http-dump` | HTTP | Catch-all HTTP request capture |\n| Profiler | `profiler` | HTTP | XHProf profiling (call graph, flame chart, top functions) |\n| Webhooks | `webhooks` | — | HTTP POST notifications when events are received |\n\n## Configuration\n\nThe server works with zero configuration. Optionally, create a `buggregator.yaml`:\n\n```yaml\nserver:\n  addr: \":8000\"\n\ndatabase:\n  driver: sqlite\n  dsn: \":memory:\"           # or \"data.db\" for persistence\n\n# Prometheus metrics (optional)\nmetrics:\n  enabled: true\n  addr: \":9090\"             # separate server, or empty to use main HTTP\n\ntcp:\n  smtp:\n    addr: \":1025\"\n  monolog:\n    addr: \":9913\"\n  var-dumper:\n    addr: \":9912\"\n\n# Authentication (disabled by default)\n# Supports: auth0, google, github, keycloak, gitlab, oidc (generic)\nauth:\n  enabled: true\n  provider: auth0\n  provider_url: https://your-tenant.us.auth0.com\n  client_id: your-client-id\n  client_secret: your-client-secret\n  callback_url: http://localhost:8000/auth/sso/callback\n  scopes: openid,email,profile\n  jwt_secret: your-secret-for-signing-tokens\n\n# MCP — AI assistant integration (disabled by default)\nmcp:\n  enabled: true\n  transport: socket              # \"socket\" or \"http\"\n  socket_path: /tmp/buggregator-mcp.sock\n\n# Enable/disable modules (all enabled by default)\nmodules:\n  sentry: true\n  ray: true\n  var-dump: true\n  inspector: true\n  monolog: true\n  smtp: true\n  sms: true\n  http-dump: true\n  profiler: true\n\n# Webhooks — HTTP POST notifications on events\nwebhooks:\n  - event: \"*\"\n    url: https://slack.example.com/webhook\n    headers:\n      Authorization: \"Bearer token\"\n    verify_ssl: false\n    retry: true\n  - event: sentry\n    url: https://pagerduty.example.com/alert\n\n# Pre-defined projects\nprojects:\n  - key: my-app\n    name: My Application\n```\n\n### Configuration Priority\n\n1. **CLI flags** (`--http-addr :9000`)\n2. **Environment variables** (`HTTP_ADDR=:9000`)\n3. **Config file** (`buggregator.yaml`)\n4. **Defaults**\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `HTTP_ADDR` | `:8000` | HTTP listen address |\n| `DATABASE_DSN` | `:memory:` | SQLite DSN |\n| `SMTP_ADDR` | `:1025` | SMTP listen address |\n| `MONOLOG_ADDR` | `:9913` | Monolog TCP address |\n| `VAR_DUMPER_ADDR` | `:9912` | VarDumper TCP address |\n| `CLIENT_SUPPORTED_EVENTS` | all | Comma-separated list of enabled modules |\n| `METRICS_ENABLED` | `false` | Enable Prometheus metrics |\n| `METRICS_ADDR` | — | Separate metrics server address |\n| `AUTH_ENABLED` | `false` | Enable OAuth2/OIDC authentication |\n| `AUTH_PROVIDER` | `oidc` | Provider: `auth0`, `google`, `github`, `keycloak`, `gitlab`, `oidc` |\n| `AUTH_PROVIDER_URL` | — | OIDC issuer URL |\n| `AUTH_CLIENT_ID` | — | OAuth2 client ID |\n| `AUTH_CLIENT_SECRET` | — | OAuth2 client secret |\n| `AUTH_CALLBACK_URL` | — | OAuth2 callback URL |\n| `AUTH_SCOPES` | `openid,email,profile` | Comma-separated OAuth2 scopes |\n| `AUTH_JWT_SECRET` | — | Secret for signing internal JWT tokens |\n| `MCP_ENABLED` | `false` | Enable MCP server |\n| `MCP_TRANSPORT` | `socket` | `socket` (local) or `http` (remote) |\n| `MCP_SOCKET_PATH` | `/tmp/buggregator-mcp.sock` | Unix socket path |\n| `MCP_ADDR` | `:8001` | HTTP listen address for MCP |\n| `MCP_AUTH_TOKEN` | — | Bearer token for HTTP MCP transport |\n\n## PHP Client Configuration\n\n### Laravel / Symfony\n\n```env\n# .env\nSENTRY_LARAVEL_DSN=http://sentry@localhost:8000/default\nRAY_HOST=ray@localhost\nRAY_PORT=8000\nVAR_DUMPER_SERVER=localhost:9912\nLOG_SOCKET_URL=localhost:9913\nMAIL_HOST=localhost\nMAIL_PORT=1025\nINSPECTOR_URL=http://inspector@localhost:8000\nINSPECTOR_API_KEY=test\nPROFILER_ENDPOINT=http://profiler@localhost:8000\nHTTP_DUMP_ENDPOINT=http://http-dump@localhost:8000\nSMS_ENDPOINT=http://localhost:8000/sms\n```\n\n## MCP (Model Context Protocol)\n\nBuggregator includes a built-in MCP server that lets AI assistants (Claude Code, Cursor, etc.) query and analyze debugging data directly.\n\n```\nAI Assistant --stdio--\u003e buggregator mcp --unix socket--\u003e buggregator (main process)\n```\n\n### Setup\n\n**Claude Code** (`~/.claude.json` or project settings):\n```json\n{\n  \"mcpServers\": {\n    \"buggregator\": {\n      \"command\": \"./buggregator\",\n      \"args\": [\"mcp\"]\n    }\n  }\n}\n```\n\n**Cursor** (`.cursor/mcp.json`):\n```json\n{\n  \"mcpServers\": {\n    \"buggregator\": {\n      \"command\": \"./buggregator\",\n      \"args\": [\"mcp\"]\n    }\n  }\n}\n```\n\n### Available Tools\n\n| Tool | Description | Key Parameters |\n|------|-------------|----------------|\n| `events_list` | List captured events | `type`, `project`, `limit` (default 20, max 100) |\n| `event_get` | Get full event payload | `uuid` |\n| `event_delete` | Delete an event | `uuid` |\n| `profiler_summary` | Profile overview: totals, slowest function, memory hotspot | `uuid` |\n| `profiler_top` | Top functions sorted by metric | `uuid`, `metric`, `limit` |\n| `profiler_call_graph` | Filtered call graph with significant paths | `uuid`, `metric`, `percentage`, `threshold` |\n| `sentry_event` | Structured error: exception chain, stack traces, tags | `uuid` |\n| `vardump_get` | Variable value with HTML stripped | `uuid` |\n\n## Building from Source\n\n### Prerequisites\n\n- Go 1.22+\n- PHP 8.1+ with Composer (for VarDumper module)\n- Make\n\n```bash\nmake build          # Full build: downloads frontend, builds PHP parser, compiles binary\nmake run            # Build and run\nmake build-cross GOOS=darwin GOARCH=arm64   # Cross-compile\n```\n\n## Documentation\n\nSee the [documentation](https://docs.buggregator.dev/) for detailed installation and usage instructions.\n\n## Contributing\n\nWe 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.\n\n\u003e Read more about how to contribute [here](https://docs.buggregator.dev/contributing.html).\n\n## License\n\nBuggregator is open-sourced software licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuggregator%2Fserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbuggregator%2Fserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuggregator%2Fserver/lists"}