Xeams DevNullSMTP on Gentoo
===========================
The xeams-devnullsmtp launcher always enables upstream's console mode and
forces Java into headless mode. A safe starting point for an isolated Bongo
test is:
install -d /tmp/bongo-devnull-mail
xeams-devnullsmtp -p 2526 -d example.test \
-s /tmp/bongo-devnull-mail -tr terminate@me.please
The arguments are:
-p PORT listen on PORT (upstream defaults to privileged port 25)
-d DOMAINS comma-separated accepted domains
-s DIRECTORY save accepted messages instead of discarding them
-tr ADDRESS terminate when a message uses ADDRESS as envelope sender
DevNullSMTP intentionally behaves as an open relay when -d is omitted. It does
not provide an option to select a listen address, so use a firewall, network
namespace or container network to keep the test listener private. Never expose
it to an untrusted network.
STARTTLS with a self-signed certificate is enabled by default. The additional
xeams-devnullsmtp-no-tls launcher disables STARTTLS for an explicit plaintext
test. A custom PKCS#12 certificate can be configured in:
/etc/java-config-2/launcher.d/xeams-devnullsmtp-bin
For example:
gjl_java_args="-Djava.awt.headless=true -Ddevnull.cert.pwd=secret \
-Ddevnull.cert.type=PKCS12 -Ddevnull.cert.file=/path/to/test-cert.p12"
The tool embeds old third-party Java libraries. Run it only inside an isolated,
short-lived test environment.