Ansible Role: ssmtp

This is an Ansible role for installing and setting up ssmtp.

Requirements

This role has been tested on Ubuntu 16.04 and Ubuntu 16.10 only.

Variables

• ssmtp_smtp_server - SMTP server

  • Required

• ssmtp_smtp_port - SMTP port

  • Default: 25

• ssmtp_use_tls - Use TLS

  • Default: no

• ssmtp_use_starttls - Use STARTTLS

  • Default: no

• ssmtp_auth_user - Username for authentication

  • Required

• ssmtp_auth_password - Password for authentication

  • Required

• ssmtp_auth_method - Method for authentication

  • Default: LOGIN

• ssmtp_sender_domain - Domain name for your sender addresses (e.g., gmail.com, company.tld)

  • Required

    Note: Some SMTP servers may refuse emails from unknown domains (e.g., mandrill).

• ssmtp_default_recipient - Address where all emails sent to service accounts will redirect (e.g., root). Leave blank to disable.

  • Default: ''

• ssmtp_host_fqdn - Hostname of the server.

  • Default: '{{ ansible_fqdn }}

    Note: Must be a fully qualified domain name; otherwise, some SMTP servers may reject the connection (e.g., Gmail).

• ssmtp_allow_sender_override - If the 'From' header is set, it can be used.

  • Default: yes

• ssmtp_sender_aliases - List of local accounts and their sending aliases

  • Default: []
  • Example:

    ssmtp_sender_aliases:
      - name: root
        alias: [email protected]
      - name: admin
        alias: [email protected]
    

Usage Example

- hosts: all
  vars:
    ssmtp_smtp_server: smtp.gmail.com
    ssmtp_smtp_port: 587
    ssmtp_use_tls: yes
    ssmtp_use_starttls: yes
    ssmtp_auth_user: username
    ssmtp_auth_password: password
    ssmtp_sender_domain: gmail.com
    ssmtp_default_recipient: [email protected]
    ssmtp_allow_sender_override: no
    ssmtp_sender_aliases:
      - name: root
        alias: 'root.{{ ansible_fqdn }}@company.tld'
  roles:
    - ssmtp

License

MIT / BSD

Author Information

This role was created by TheDumbTechGuy ( twitter | blog | galaxy )

Credits