libreshop/mail

Python microservice for transactional shop mail.

Part of the libreshop toolkit. Image published at git.librete.ch/libreshop/mail on every push to main and on v* tags.

Source

This repo was extracted from mp/mail/ on 2026-04-29; mp was the first concrete adapter consuming the toolkit. mp's compose.yml now pulls git.librete.ch/libreshop/mail:<pin> instead of building locally.

Build locally

docker build -t libreshop/mail:dev .

Settings

variable	meaning
SMTP_RELAY_HOST, SMTP_RELAY_PORT	the SMTP server
SMTP_RELAY_SECURITY	ssl (port 465), starttls (587 or 25) or none (a relay on a private network); default by port
SMTP_RELAY_USERNAME, SMTP_RELAY_PASSWORD	login, used only when both are set
SMTP_FROM	sender, e.g. MUELLERPRINTS <shop@example.org>; default SMTP_RELAY_USERNAME
SMTP_REPLY_TO	optional reply address

GET /health answers 503 when the SMTP server does not accept the connection.

Adapter contract

See docker-entrypoint.sh and Dockerfile for the runtime surface. Adapters configure the component via env vars and bind-mounted volumes; do not patch the running container or rely on internal paths.