Cookbook — Manual Installation

Buggregator is a single self-contained binary with no external dependencies. You don't need Docker, PHP, Go, or any runtime to run it.

Download

Download the latest release for your platform from GitHub Releases:

# Linux (amd64)
curl -L -o buggregator https://github.com/buggregator/server/releases/latest/download/buggregator-linux-amd64
chmod +x buggregator

# Linux (arm64)
curl -L -o buggregator https://github.com/buggregator/server/releases/latest/download/buggregator-linux-arm64
chmod +x buggregator

# macOS (Apple Silicon)
curl -L -o buggregator https://github.com/buggregator/server/releases/latest/download/buggregator-darwin-arm64
chmod +x buggregator

# macOS (Intel)
curl -L -o buggregator https://github.com/buggregator/server/releases/latest/download/buggregator-darwin-amd64
chmod +x buggregator

Run

./buggregator

Open http://127.0.0.1:8000 in your browser. That's it.

Configuration

By default, Buggregator runs with in-memory storage (data is lost on restart). To persist data, create a buggregator.yaml file next to the binary:

database:
  dsn: data.db                    # Persist events to a SQLite file

storage:
  mode: filesystem                # Persist attachments to disk
  path: ./storage

Or specify a custom config path:

./buggregator --config /etc/buggregator/buggregator.yaml

See the server configuration guide for all available options.

Default Ports

Port	Service
8000	HTTP (Web UI + API)
1025	SMTP
9912	VarDumper (TCP)
9913	Monolog (TCP)

All ports are configurable via environment variables or the config file.