Nodemailer to a local inbox, no real email sent

1. Start Buggregator

Install the binary and run it. It is one file with no dependencies. The SMTP server starts on port 1025, the web UI on port 8000.

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

If ~/.local/bin is not in your PATH, run ~/.local/bin/buggregator. Prefer containers? Use Docker or Docker Compose, as shown on Getting Started.

2. Create the transport

Use this transport in development. No authentication is needed and there is no TLS to configure.

const transporter = nodemailer.createTransport({
    host: '127.0.0.1',
    port: 1025,
    secure: false,
});

If your app runs in Docker Compose, replace 127.0.0.1 with the Buggregator service name, for example buggregator.

3. Send a message as usual

Your code that sends mail through transporter stays the same. Trigger an email from your app: a sign-up, a reset link, a report.

4. Open the inbox

Open http://127.0.0.1:8000. Each message shows the rendered HTML with a desktop/mobile switcher, the plain text version, From, To, CC, BCC and Reply-To, the attachments and the raw MIME source.

Buggregator includes a fake SMTP server. Nodemailer talks to it like to any mail server, but Buggregator stores the email and shows it in the UI instead of delivering it. Any app that can send email over SMTP works the same way, so your Node, PHP, Python and Ruby apps can share one inbox.