coop-cloud
/
postfix-relay
generated from coop-cloud/example
1
0
Fork 0
Code Issues 1 Pull Requests Releases Wiki Activity
Simple SMTP server / postfix null relay host https://github.com/bokysan/docker-postfix
26 Commits 1 Branch 0 Tags 53 KiB
Go to file
Javielico 05e067b7f3
continuous-integration/drone/push Build is passing Details
chore: publish v4.3.0-282de499 release 		2024-09-04 11:59:39 +01:00
.drone.yml Switch to self-hosted stack-ssh-deploy image [mass update] 2023-01-21 11:49:56 -08:00
.env.sample Fix embarrassing mass-typo 😳 2020-12-31 23:02:27 +02:00
.gitignore Initial commit 2020-09-26 11:17:53 +02:00
README.md Update abra syntax in examples (finally) [mass update] 2023-01-19 16:02:28 -08:00
compose.yml chore: publish v4.3.0-282de499 release 2024-09-04 11:59:39 +01:00

README.md

Postfix-Relay

Build Status

  • Category: Utilities
  • Status: 2, beta
  • Image: boky/postfix, 4, upstream
  • Healthcheck: Yes
  • Backups: No
  • Email: N/A
  • Tests: 2
  • SSO: N/A

Centralised email delivery for all your coop-cloud apps using the boky/postfix outgoing-only mail image.

The basic idea is to run one instance of this on each swarm, and configure that swarm's apps to send all their email through it.

By default, this stack will try to deliver e-mail directly (i.e. looking up the recipient's mail server using MX records). NOTE: make sure that:

  • your Traefik server and host firewall are configured to allow port 587,
  • you have an MX record for your configured $DOMAIN pointing to this server,
  • you have an SPF record for $DOMAIN that includes mx or this server's IP
  • you have a reverse DNS (rDNS / PTR) record for this IP that matches $DOMAIN

(These requirements mean that you can only deploy one direct-delivery instance of this app per swarm host..)

Alternatively, you can easily route mail through a smarthost / relay host like Mailgun or Gandi -- see RELAYHOST and related parameters.

FIXME 3wc: Pass RELAYHOST etc. from .envrc to service

Basic usage

  1. Set up Docker Swarm and [abra][abra]
  2. Deploy [coop-cloud/traefik][compose-traefik]
  3. abra app new postfix-relay
  4. abra app config YOURAPPDOMAIN - be sure to change $DOMAIN to something that resolves to your Docker swarm box
  5. abra app deploy YOURAPPDOMAIN

Using this in other stacks

Add the other service to the (internal) mail network, and set whatever options the image supports for auto-configuring SMTP settings.

For reusable stacks, you probably want to put this configuration in a separate compose.mailrelay.yml file, e.g. the version in coop-cloud/wordpress.