Skip to content

Security and data ​

Buggregator is a debugging tool for your own machine or a trusted dev network. It has no accounts, sends no analytics and reports no usage. This page lists, without gaps, what it does send, who can reach it, and where your events are kept. Everything here is true for server 2.11.0.

What leaves your machine ​

Always on ​

WhatWho sendsWhere toWhenHow to turn it off
New-version checkthe serverhttps://api.github.com/repos/buggregator/server/releases/latestat start, then every 12 hoursUPDATE_CHECK_ENABLED=false
Source of JavaScript errorsthe serverthe URL of each file in a JavaScript stack traceeach Sentry error from a browser or JS appSENTRY_SOURCE_FETCH=off (since 2.11.0)
Images and styles inside captured HTMLyour browserthe hosts named in that HTML (e.g. a tracking pixel)when you open an HTML email or an HTML HTTP dumpno switch

New-version check. One GET request. Besides your IP address, it carries only the server version (User-Agent: buggregator/2.11.0). Nothing about your events or projects is sent. With UPDATE_CHECK_ENABLED=false the server makes no such call at all. Details: Server → New-Version Check.

UI fonts. Since server 2.11.0 the fonts (DM Sans, JetBrains Mono) are part of the UI, and the browser loads nothing from Google Fonts. Server 2.10.0 and older load them from fonts.googleapis.com and fonts.gstatic.com, so Google sees the IP address of the browser that opens the UI. No event data goes there.

Source of JavaScript errors. Browser SDKs send stack frames with a file URL but no code, e.g. http://localhost:5173/src/App.vue. To show the code, the server downloads that file: up to 2 MiB, 3-second timeout, TLS certificates not checked. In server 2.10.0 and older it does this for any http:// or https:// URL in a frame, not only for local ones. So whoever can send a Sentry event to your Buggregator can make it request a URL from inside your network. Keep the server where only your apps can reach it (see below).

Since server 2.11.0, the server fetches only from loopback and private addresses by default (127.0.0.0/8, ::1, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, fc00::/7): your dev server, a Docker service. One setting changes it: sentry.source_fetch in buggregator.yaml, SENTRY_SOURCE_FETCH or --sentry-source-fetch, with private (default), any (every host, as in 2.10.0 and older) or off (never fetch). The check is made on the resolved IP address, cloud metadata addresses are refused, and redirects go only to the same host. Details: Server → Sentry Source Fetch.

Images and styles inside captured HTML. An HTML email or an HTML HTTP dump is shown as it is. Scripts in it do not run, but its images and stylesheets load from wherever they point. So when you open a captured email, your browser requests its images, tracking pixels included, and the sender may see that the email was opened.

When you click it ​

WhatWho sendsWhere toWhenHow to turn it off
Check now (since server 2.11.0)the serverthe same GitHub address as the new-version checkwhen you click it, at most once a minuteUPDATE_CHECK_ENABLED=false
Update to <version> (since server 2.11.0)the serverthe release files on GitHub: the program for your system, checksums.txt, checksums.txt.sigwhen you click itUPDATE_SELF=off

UPDATE_RELEASE_URL (update.release_url) points both at a mirror of GitHub's releases/latest instead. The download is still checked against the signing key built into Buggregator. See Install → Update.

Only when you turn it on ​

FeatureWhere it connects
SSOyour login provider (GitHub, Google, Auth0, Keycloak, GitLab, OIDC)
Webhooksthe URLs you configure
Mock server OpenAPI import from a URLthe URL you enter
HTTP proxythe hosts your app sends through it
Xdebug proxyyour IDE's address

Nothing else makes outgoing connections.

Who can reach it ​

The binary ​

Every port listens on all network interfaces by default. Anyone on your network who can reach your machine can open the UI, read your events and send new ones.

PortWhatDefault
8000web UI, API, HTTP events:8000, all interfaces
1025SMTP:1025, all interfaces
9912VarDumper:9912, all interfaces
9913Monolog:9913, all interfaces
8080HTTP proxy:8080, all interfaces
9003Xdebug proxy (off by default)127.0.0.1:9003
8001MCP over HTTP (only with MCP_ENABLED=true and MCP_TRANSPORT=http):8001, all interfaces
METRICS_ADDRPrometheus metrics on their own port (only when you set it)the address you set

MCP over HTTP asks for no token unless you set MCP_AUTH_TOKEN. Bind it with MCP_ADDR=127.0.0.1:8001. The default MCP transport is a local socket file, which opens no port.

The HTTP proxy deserves a note. It forwards requests to any host, also HTTPS, and asks for no password. On all interfaces, it is an open proxy for everyone on your network.

To keep everything on your machine:

bash
PROXY_ADDR=127.0.0.1:8080 ./buggregator \
  -http-addr 127.0.0.1:8000 \
  -smtp-addr 127.0.0.1:1025 \
  -vardumper-addr 127.0.0.1:9912 \
  -monolog-addr 127.0.0.1:9913

The same with environment variables: HTTP_ADDR, SMTP_ADDR, VAR_DUMPER_ADDR, MONOLOG_ADDR, PROXY_ADDR.

Docker ​

Inside the container the server listens on all interfaces; that is fine. What matters is how you publish the ports. Always put 127.0.0.1: in front:

yaml
ports:
  - "127.0.0.1:8000:8000"   # only this machine
  # - "8000:8000"           # every machine that can reach yours

Containers on the same compose network reach Buggregator by its service name. They need no published ports at all. Publish only what you open from your machine: usually just 8000.

What SSO protects ​

SSO puts a login in front of the UI and the APIs the UI uses. These stay open, also with SSO on:

  • event ingestion (Sentry, Ray, Inspector, profiler, SMS, HTTP dumps) and the SMTP, VarDumper and Monolog ports;
  • the HTTP proxy;
  • the mock server under /mock/;
  • /api/version, /api/settings and attachment links;
  • MCP over HTTP on :8001: it has its own token, MCP_AUTH_TOKEN;
  • Prometheus GET /metrics, when metrics are on: on port 8000, or on METRICS_ADDR if set.

So SSO keeps strangers from reading your events, but not from sending them. On a shared server, also limit who can reach the ports, e.g. with a firewall or a private network.

Scripts call the protected API with the token the UI gets after login (30 days). See SSO → Calling the API from Scripts.

Where your data is kept ​

WhatDefaultTo keep it on disk
Eventsin memory: gone when the server stopsDATABASE_DSN=/data/buggregator.db (SQLite file)
Email attachments, HTTP dump filesin memorySTORAGE_MODE=filesystem, STORAGE_PATH=…

Details: Database.

How long. By default the server deletes nothing by itself. Events stay until you clear them in the UI, call DELETE /api/events, or restart a server that keeps them in memory. With a database file, the file grows until you clear it.

Since server 2.11.0, you can let it delete old events by itself:

bash
RETENTION_MAX_AGE=7d RETENTION_MAX_EVENTS=5000 ./buggregator
  • RETENTION_MAX_AGE (retention.max_age, --retention-max-age): delete events older than this, e.g. 30m, 24h, 7d. Empty or 0: keep.
  • RETENTION_MAX_EVENTS (retention.max_events, --retention-max-events): keep at most this many events, the newest. 0: no cap.

Nothing is deleted unless you set one of them. The cleanup runs at start and then every minute. Attachments go with their events. Pinned events are never deleted and do not count towards the cap.

What goes with them:

  • Deleting an event (in the UI, with DELETE /api/events, or by retention) also deletes its Sentry error details.
  • RETENTION_MAX_AGE also removes Sentry logs and metrics by the time they arrived, and traces and spans by their start time. The error details of a pinned event stay.
  • RETENTION_MAX_EVENTS counts event cards only. It does not touch Sentry logs, metrics or traces.
  • Clearing events by hand does not remove Sentry logs, metrics and traces. Remove those with Clear on the Sentry page or DELETE /api/sentry/all (see Sentry → Clearing data).

In 2.10.0 and older, deleting an event left its Sentry error details in the database.

Versions ​

Releases are numbered major.minor.patch (e.g. 2.11.0). A minor release may still change behaviour, so read the release notes before you upgrade.

Pin the version and upgrade on purpose:

yaml
image: ghcr.io/buggregator/server:2.11.0
TagWhat you get
2.11.0exactly this release, never changes
2.11the newest 2.11.x patch
2the newest 2.x release
latestthe newest release, whatever it is

The image tags have no v: 2.11.0, not v2.11.0. Release pages and binaries use v2.11.0.

Security fixes go into the newest release only. To get a fix, upgrade.

Report a vulnerability ​

See SECURITY.md in the server repository.