Skip to main content

Spring Boot mail to a local inbox, two properties

To test Spring Boot mail without sending it, set two properties: spring.mail.host and spring.mail.port=1025, pointed at Buggregator. Every email your app sends with JavaMailSender then lands in a local inbox, with the HTML preview, the attachments and the raw source. Nothing reaches a real address.

Steps

1. Start Buggregator

Run the container. Port 8000 is the web UI, port 1025 is the SMTP server.

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

2. Set the mail properties in a local profile

Put them in a profile file such as application-local.properties, so they never reach production. No user, password or TLS is needed.

properties
spring.mail.host=127.0.0.1
spring.mail.port=1025

Your app needs spring-boot-starter-mail on the classpath. Spring Boot creates the JavaMailSender bean once spring.mail.host is set.

3. Use the service name in Docker Compose

If your app runs in the same Compose stack as Buggregator, use the service name as the host.

properties
spring.mail.host=buggregator
spring.mail.port=1025

4. Send an email and open it

Run the app with the local profile and trigger any email. Open http://127.0.0.1:8000. You see the rendered HTML, the plain text version, the addresses, the attachments and the raw MIME source.

Why it works

Buggregator includes a fake SMTP server on port 1025. JavaMailSender delivers to it like to any mail server, and Buggregator stores the email and shows it in the UI instead of sending it on. Your mail code does not change, only two properties in a local profile.

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