Postfix Relay

Postfix Relay is a containerized SMTP relay built on Postfix, designed to let self-hosted applications and services send outbound email without requiring an…

  • Cloud
  • Communication
  • Network Services
  • Other
  • Productivity
  • Tools & Utilities
Postfix Relay is a containerized SMTP relay built on Postfix, designed to let self-hosted applications and services send outbound email without requiring an external mail provider.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

69/100 Good

Maintained
100last commit 24 days ago
Popular
45169 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
404 GB minimum RAM, runs on ARM
Security check
95no serious findings, CI, tests

Availability: platform listings confirmed today, links checked 53 days ago

GitHub stars
169
Open issues
31
Last commit
2026-10-28
Latest release
v1.2.17
License
MIT
Activity
declining

Checked 23 days ago - source: GitHub (wader/postfix-relay)

Resources & Compatibility

Minimum requirements: 4 GB RAM. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set relay and sender domain settings Before starting, set the RELAYHOST address and its username/password if you are sending through an outside mail service, and set ALLOWED_SENDER_DOMAINS to the domains you send from. Without these, Postfix can reject messages or not know how to deliver them through your provider. source
  • Expose port 1587 for mail submission Map host port 1587 to container port 587 with -p 1587:587, because 587 is the standard port for mail programs to submit messages. If you skip it, other devices cannot send mail through this container unless they are already on the same Docker network. source
  • Trust your app's network address If local apps need to send mail by network address, add their IP range to POSTFIX_mynetworks. Without this, Postfix treats them as strangers and may refuse their mail. source
  • Security Do not expose the relay publicly; default setup relies on Docker networking for protection. source
  • Securing the relay The default configuration is an open relay protected by Docker networking; do not expose it publicly. source
  • Open relay by default The image is an open relay by default, protected only by Docker networking; do not expose the SMTP port publicly. source

Fetched 2 days ago - each note links to its source

Alternatives (3)

  • OpenSMTPD - OpenSMTPD is a free server-side SMTP (Simple Mail Transfer Protocol) transfer agent that sends, relays, and receives email for homelabs and…
  • Sendmail - Sendmail is a general purpose internetwork email routing facility that supports many kinds of transfer and delivery methods, including the…
  • Stalwart - Stalwart is an open-source, all-in-one email server that unifies JMAP, IMAP (Internet Message Access Protocol), and SMTP (Simple Mail Trans…

Checked 51 days ago - source: AlternativeTo

Common questions

Should I publish the Postfix Relay SMTP port to the internet?

No. The default configuration is an open relay that relies on Docker networking for protection, so it should not be exposed publicly.

How do I let another container in the same compose stack send mail through it?

Put the app container and the Postfix Relay container on the same Docker network. The example points the app at the smtp service host for outbound mail.

Which variable sets the FQDN used by Postfix for 220 and HELO?

Set POSTFIX_myhostname to the desired FQDN. The image defaults it to hostname if you leave it unset.

How can I turn off a Postfix setting that the image enables by default?

Set the corresponding POSTFIX_ environment variable to an empty value. Some parameters do not accept an empty value, such as error_notice_recipient.

Answers sourced from github.com

Community

Collected 53 days ago - public community threads