Files
mail/README.md
T
libretech 2efca9415e
build / build (push) Failing after 7s
build / test (push) Successful in 16s
One secured SMTP path, optional login, sender and reply address, failing health (#3)
Co-authored-by: Michael Czechowski <mail@librete.ch>
2026-10-15 10:43:10 +02:00

1.2 KiB

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.