postfix_send_only_relay

An Ansible role to install Postfix and configure as send-only via an SMTP relay.

About

This role is designed to be used on a server that will only send emails and not receive them. This is useful for recieving emails from cron jobs or other services/applications that want to send emails from a server.

Requirements

A SMTP relay service is required.

Your email provider may offer a SMTP relay service. If not, there are several popular SMTP relays that offer free tiers (others are also available).

Supported Distros

• AlmaLinux >= 8
• AmazonLinux 2023
• CentOS >= 7
• Debian >= 10
• Fedora >= 37
• openSUSE >= 15.4
• OracleLinux >= 8
• Pop!_OS >= 18.04
• Redhat Enterprise Linux >= 8
• Rocky Linux >= 8
• Ubuntu >= 18.04

Role Variables

---
# Config path for postfix
postfix_config_file: "/etc/postfix/main.cf"

# The domain that is used to send emails.
postfix_mydomain:

# The domain that is used to send emails if no domain is specified. This is usually the same as mydomain or myhostname
postfix_myorigin: "$mydomain"

# mydestination controls a list of domains that postfix considers itself the final destination for.
## When aliases are set, postfix needs to "proccess" the email to then forward it on using /etc/aliases.
## example: root -> postfix -> [email protected] - > aliases -> [email protected] -> relayhost -> [email protected]
postfix_mydestination: "$myhostname, localhost.$mydomain, localhost, $mydomain"
## When aliases are not required localhost only entry will forward on all emails without any "processing" from postfix.
## example: root -> postfix -> [email protected] -> relayhost -> [email protected]
# postfix_mydestination: "localhost"

# interfaces that can send emails - loopback-only allowes only localhost to send.
postfix_inet_interfaces: "loopback-only"

# The relay host of SMTP server.
postfix_relayhost:

# Username for SMTP server.
postfix_sasl_username:
# Password for SMTP server.
postfix_sasl_password:

# The domain that the mail command will use.
postfix_mail_send_domain: "{{ postfix_mydomain }}"

# Email address alias that will recieve all emails sent to the servers root user.
postfix_root_alias:

# Email address to recieve test email when role is run.
postfix_test_send_email:

Dependencies

community.general

Example Playbook

---
- name: Linux Admin Packages
  hosts: all
  vars:
    postfix_mydomain: "example.com"
    postfix_relayhost: "[in-v3.mailjet.com]:587"
    postfix_sasl_username: "username"
    postfix_sasl_password: "password"
    postfix_root_alias: "[email protected]"
  roles:
    - role: "dgibbs64.postfix_send_only_relay"

License

MIT

Author Information

• Daniel Gibbs