Configure direct-delivery incoming email for self-hosted sites with Mail-Receiver

Documentation Self-Hosting
, , ,
529

On my dedicated server (running Ubuntu 22.04, with Postfix installed) I use a separate mail-receiver.yml paired to each instance of Discourse where I have enabled the mail-in posting feature.

This setup creates a separate container for each instance of Discourse on my server (alongside the typical app container) which receives and processes the e-mails for its corresponding Discourse instance.

Incoming emails for all of the Discourse forums on the server are received by Postfix through the standard port 25, where the main Postfix configuration file uses a “transport map” to “relay” each email to its intended Discourse forum by parsing out the domain name in the email’s “To:” address.

So, in addition to the instructions of this Topic, I…

  1. modified the existing postfix configuration file at: /etc/postfix/main.cf

    The image shows a text editor window displaying a configuration script in the "main.cf" file for a Discourse forum, which includes instructions for routing emails to multiple Discourse forums and a requirement to create a transport map file. (Captioned by AI)
    The image shows a text editor window displaying a configuration script in the "main.cf" file for a Discourse forum, which includes instructions for routing emails to multiple Discourse forums and a requirement to create a transport map file. (Captioned by AI)1028×961 171 KB

  2. then, I added the corresponding postfix transport map file at: /etc/postfix/transport

    transport
    transport405×226 24.3 KB

The image shows a file explorer window displaying a directory named "/etc/postfix" with various files and subdirectories related to the Postfix mail transfer agent. (Captioned by AI)
The image shows a file explorer window displaying a directory named "/etc/postfix" with various files and subdirectories related to the Postfix mail transfer agent. (Captioned by AI)851×478 104 KB

  1. lastly, I added the corresponding files to create the email container for each of the forums:
    /var/discourse/containers/mail-receiver-domain1.yml
    /var/discourse/containers/mail-receiver-domain2.yml
    /var/discourse/containers/mail-receiver-domain3.yml
    /var/discourse/containers/mail-receiver-domain4.yml
    /var/discourse/containers/mail-receiver-domain5.yml
    An image showing a YAML data file with various comments and settings for a mail receiver container template. (Captioned by AI)
    An image showing a YAML data file with various comments and settings for a mail receiver container template. (Captioned by AI)689×948 154 KB

A WinSCP window showing a directory structure with various files, including several "mail-receiver-domain1.yml" files highlighted. (Captioned by AI)
A WinSCP window showing a directory structure with various files, including several "mail-receiver-domain1.yml" files highlighted. (Captioned by AI)838×710 163 KB

2 Likes