Add basic docs for Postfix w/ Gmail relay

This commit is contained in:
Lance Edgar 2022-10-28 13:09:57 -05:00
parent 82c2f5a065
commit 32fa8dc6fe

View file

@ -1,5 +1,43 @@
.. highlight:: sh
Postfix Setup Postfix Setup
============= =============
TODO The typical scenario for a Rattail server is that it runs Linux and
Postfix for the mail service. Here we describe that typical setup.
Basics
------
If you don't already have Postfix installed, do that first::
sudo apt install postfix
It's normally a good idea to declare your domain and hostname.
Assuming your server is ``myserver.example.com`` then::
sudo postconf -e 'myhostname=myserver.example.com'
sudo postconf -e 'myorigin=example.com'
sudo systemctl restart postfix
Gmail Relay
-----------
Make sure Postfix knows to send all mail through Gmail relay::
sudo postconf -e 'relayhost=smtp-relay.gmail.com:25'
sudo systemctl restart postfix
This however assumes the Gmail relay is also configured to allow mail
from your server. The most straightforward way to do this is
via IP address authentication.
See `Google Help`_ for more info, but the gist is that you should
choose "Only accept mail from the specified IP addresses" for the
relay authentication within Google Admin settings. And then specify
the public-facing IP address for your server.
.. _Google Help: https://support.google.com/a/answer/2956491?hl=en