/ansible-role-postfix

Primary LanguageHTMLMIT LicenseMIT

Ansible Role: Postfix

Gitlab pipeline status (self-hosted) Ansible role Ansible role downloads Ansible Quality Score Liberapay patrons Liberapay receiving

Installs and configures the Postfix SMTP server with database integration.

Requirements

Ansible version 2.0 or higher.

Role Variables

Available variables are listed below, along with their default values (see defaults/main.yml for more info):

dubzland_postfix_cert_file

dubzland_postfix_cert_file: /etc/ssl/certs/ssl-cert-snakeoil.pem

Certificate to use when authenticating TLS connections.

dubzland_postfix_key_file

dubzland_postfix_key_file: /etc/ssl/private/ssl-cert-snakeoil.key

Private key matching the certificate specified above.

dubzland_postfix_host_name

dubzland_postfix_host_name: mail.example.com

Postfix myhostname value.

dubzland_postfix_domain_name

dubzland_postfix_domain_name: example.com

Postfix mydomain value.

dubzland_postfix_networks

dubzland_postfix_networks: "127.0.0.0/8, 192.168.0.0/24"

Postfix mynetworks value.

dubzland_postfix_db_host

dubzland_postfix_db_host: 127.0.0.1

Host where the PostgreSQL database lives.

dubzland_postfix_db_username/dubzland_postfix_db_password

dubzland_postfix_db_username: mailuser
dubzland_postfix_db_password: notsekret

Credentials used to connect to the PostgreSQL database.

dubzland_postfix_db_name

dubzland_postfix_db_name: mailserver

Name of the PostgreSQL database containing mailbox data.

dubzland_postfix_virtual_alias_maps_query

dubzland_postfix_virtual_alias_maps_query: "SELECT destination FROM virtual_aliases WHERE source = '%s'"

dubzland_postfix_virtual_email2email_query

dubzland_postfix_virtual_email2email_query: "SELECT email FROM virtual_users WHERE email='%s'"

dubzland_postfix_virtual_mailbox_domains_query

dubzland_postfix_virtual_mailbox_domains_query: "SELECT 1 FROM virtual_domains WHERE name='%s'"

dubzland_postfix_virtual_mailbox_maps_query

dubzland_postfix_virtual_mailbox_maps_query: "SELECT 1 FROM virtual_users WHERE name='%s'"

Queries needed to retrieve mailbox data from the PostgreSQL database.

Dependencies

None.

Example Playbook

- hosts: mailserver
  become: yes
  roles:
    - role: dubzland.postfix
      vars:
        dubzland_postfix_cert_file: /etc/letsencrypt/live/example.com/fullchain.pem
        dubzland_postfix_key_file: /etc/letsencrypt/live/example.com/privkey.pem
        dubzland_postfix_host_name: mail.example.com
        dubzland_postfix_domain_name: example.com
        dubzland_postfix_networks: "127.0.0.0/8, 10.0.0.0/24"

License

MIT

Author