Skip to main content

A desktop notification for each new error

Open Buggregator at http://localhost:8000 and turn on Settings › Notifications › Desktop notifications. Each new Sentry error from your app then shows a system notification while you work in another window. Several errors within 10 seconds come as one notice, and a click opens the error.

Steps

1. Start Buggregator on your machine

Notifications work only when the page is https or localhost, so bind the port to your machine.

bash
docker run --pull always \
  -p 127.0.0.1:8000:8000 \
  ghcr.io/buggregator/server:latest

2. Open it as localhost

Open http://localhost:8000. A LAN address or a host name such as http://buggregator:8000 over plain http does not get notifications.

3. Turn notifications on

Go to Settings › Notifications and switch on Desktop notifications. The browser asks for permission once and shows a test notice.

4. Send an error and switch away

Point your app's Sentry DSN at Buggregator, for example:

dotenv
SENTRY_LARAVEL_DSN=http://sentry@127.0.0.1:8000/1

Keep the Buggregator tab open and go back to your editor. When the app throws an exception, or logs a message at level error or fatal, a notice pops up. Three errors close together come as «3 new errors». Click the notice to open the error.

5. Add an app icon badge if you like

Install Buggregator as an app from the install icon in the address bar of Chrome or Edge. While its window is in the background, the app icon shows how many new events of the current project arrived. The badge works on Windows and macOS.

Why it works

The page listens for new events over WebSocket and uses the browser's notification permission. It notifies only while no Buggregator tab is in front of you, and with several tabs open only one of them notifies. The tab must stay open: a closed tab shows nothing. Chrome on Android does not show notifications from a page.

Checked on with Buggregator v2.13.0

Setup in 60 seconds

No registration. No account. Start it and point your app at it.

1

Start Buggregator

One file, installed with one command. The web UI opens on port 8000. Prefer containers? Use the Docker tab.

$ curl -fsSL https://raw.githubusercontent.com/buggregator/server/master/scripts/install.sh | sh
$ HTTP_ADDR=127.0.0.1:8000 \
  SMTP_ADDR=127.0.0.1:1025 \
  VAR_DUMPER_ADDR=127.0.0.1:9912 \
  MONOLOG_ADDR=127.0.0.1:9913 \
  PROXY_ADDR=127.0.0.1:8080 \
  ~/.local/bin/buggregator

The script picks the file for your CPU: Intel/AMD or ARM.

One file for Linux, macOS and Windows, about 40 MB. Nothing else to install.

This run line keeps it on this computer. Without the *_ADDR settings it listens on all network interfaces

Rather not run a script? Download the file yourself

Runs on Windows, macOS and Linux, on Intel/AMD and ARM.

Prefer not to do it yourself? Your AI agent can set Buggregator up for you