Skip to main content

A fake SMTP server as one binary, no Docker

Buggregator is a fake SMTP server in one file. Install it with one command, run buggregator, and set your app's SMTP host to 127.0.0.1 and port to 1025. Every email your app sends lands in the inbox at http://127.0.0.1:8000 instead of a real mailbox. No Docker, no PHP, no database server.

Steps

1. Install the binary

On Linux and macOS, the install script picks the file for your system, checks its checksums and puts it in ~/.local/bin/buggregator. No sudo.

bash
curl -fsSL https://raw.githubusercontent.com/buggregator/server/master/scripts/install.sh | sh

On Windows, in PowerShell:

powershell
irm https://raw.githubusercontent.com/buggregator/server/master/scripts/install.ps1 | iex

2. Start it

By default every port listens on all network interfaces. The flags keep the UI and SMTP on your machine only, and -db keeps your emails after a restart.

bash
buggregator -http-addr 127.0.0.1:8000 -smtp-addr 127.0.0.1:1025 -db ./buggregator.db

If ~/.local/bin is not in your PATH, run ~/.local/bin/buggregator.

On Windows, the installer does not add the binary to PATH. In PowerShell:

powershell
& "$env:LOCALAPPDATA\Programs\buggregator\buggregator.exe" -http-addr 127.0.0.1:8000 -smtp-addr 127.0.0.1:1025 -db .\buggregator.db

3. Point your app's SMTP at it

Host 127.0.0.1, port 1025. A user name and password are optional: Buggregator accepts any, and a user name picks the project the email lands in. For a Laravel app:

dotenv
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=1025

For Symfony: MAILER_DSN=smtp://127.0.0.1:1025.

4. Send a test email without an app

curl speaks SMTP too. Write a small message and send it:

bash
printf 'From: app@example.com\r\nTo: user@example.com\r\nSubject: Hello\r\n\r\nIt works.\r\n' > mail.txt
curl smtp://127.0.0.1:1025 \
  --mail-from app@example.com \
  --mail-rcpt user@example.com \
  --upload-file mail.txt

Open http://127.0.0.1:8000. The email is there with its HTML preview, plain text, addresses, attachments and raw source.

Why it works

Buggregator includes an SMTP server on port 1025 that stores each email instead of delivering it. The same binary serves the web UI on port 8000, with the frontend and SQLite built in, so there is nothing else to install. If port 1025 is already taken, Buggregator stops at start with address already in use; move it with -smtp-addr :2525.

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