ref: 6f1e423b618e64ca10741b70712b315fda9e595a epistula/README.md -rw-r--r-- 3.4 KiB
6f1e423bJan Baudisch builds: use archlinux 1 year, 4 months ago

Build Status


An HTTP server, that listenes for incoming requests to send an email via an SMTP server.



  • OpenSSL
  • Rust (when building from source)

#From Source

This project is built using cargo:

cargo build --release

The resulting binary will be at target/release/epistula

You might also want to install the example .env file, for example to /etc/epistula/epistula.env, as well as the Systemd service file epistula.service.


I maintain a copr repo for Fedora and CentOS. To enable it and install the package run:

sudo dnf copr enable janbaudisch/epistula
sudo dnf install epistula


See the manpage for epistula(1).


epistula is configured via environment variables. When run in debug mode, variables from the .env are merged with the environment.

Variable Default Description
LOGGING warn Debugging level for logger. One of trace, debug, info, warn or error.
HTTP_ADDRESS "" Address to listen on, in IP:PORT format.
UNIX_SOCKET none (UNIX only) socket (path) to listen on, if set will take precedence over HTTP (will not be enabled).
SMTP_HOST none SMTP host/domain to connect to for sending mails.
SMTP_PORT 465 SMTP port to connect to.
SMTP_TLS true Wether or not to use TLS for SMTP.
SMTP_USER none Username to use when authenticating with SMTP.
SMTP_PASSWORD none Password to use when authenticating with SMTP.
SMTP_TO none Mail address to send to.
SMTP_SUBJECT "New message" Subject line to use within mails.

See .env for an example configuration.



Make sure, your environment is setup correctly. Then run the server:


There is a Systemd service epistula.service provided. To enable it run:

systemctl enable epistula

The provided service file will take the environment variables from /etc/epistula/epistula.env.


See the issue tracker.