ansible-role-postfix's Introduction

Postfix Role for Ansible

This role configures Postfix which is a free and open-source mail transfer agent (MTA) that routes and delivers electronic mail, intended as an alternative to the widely used Sendmail MTA.

Requirements

This role requires Ansible version 1.4 or higher and the Debian/Ubuntu platform.

Role Variables

The variables that can be passed to this role and a brief description about them are as follows:

# The FQDN for the Postfix email server
postfix_domain: ''

# The receiving email address where root email is forwarded
postfix_notify_email: false

# The next-hop destination of non-local mail, for SMTP define a FQDN or hostname
postfix_relayhost: ''

# The default flag for whether to enable SMTP sending
postfix_use_smtp: false

# The username for SMTP authentication
postfix_relayhost_user: false

# The password for SMTP authentication
postfix_relayhost_pass: false

Examples

Install Postfix with the default settings

---
# This playbook installs Postfix email server

- name: Apply Postfix to mail nodes
  hosts: all
  roles:
    - { role: postfix,
        postfix_domain: 'example.com',
        postfix_notify_email: '[email protected]'
      }

Install Postfix and configure to use SMTP relay (Mandrill, MailGun, SendGrid, etc.)

---
# This playbook installs Postfix email server

- name: Apply Postfix to mail nodes
  hosts: all
  roles:
    - { role: postfix,
        postfix_domain: 'example.com',
        postfix_notify_email: '[email protected]',
        postfix_use_smtp: true,
        postfix_relayhost: '[smtp.mandrill.com]',
        postfix_relayhost_user: 'mandrill_username',
        postfix_relayhost_pass: 'mandrill_apikey'
      }