Skip to content

joelnb/ansible-msmtp

Repository files navigation

Build Status

Readme

This ansible role deploys msmtp for Ubuntu 18.04

Prerequisite

  • Having ansible installed on your workstation.
  • Having an SMTP server

How to install

  • Use github to clone/fork in your role directory
  • ansible galaxy ansible-galaxy install joelnb.msmtp

Variables

All the default variables are located defaults/main.yml. Mostly you would need to configure the following variables.

  • msmtp_accounts: You can define one or more smtp account

    msmtp_accounts:
    - account: "gmail"
      host: "smtp.gmail.com"
      port: 587
      auth: "on"
      user: "[email protected]"
      password: "some password"
    - account: "mysmtp"
      host: "smtp.example"
      port: 587
      auth: "on"
      user: "myuser"
      password: "123456"
  • msmtp_default_account: Default smtp account to use

    msmtp_default_account: "gmail"

  • msmtp_from: From field

    msmtp_from: "No Reply"

  • Logging

    • Option A (syslog)

      msmtp_log: "syslog"
    • Option B (file logging)

      msmtp_log: "file"
      msmtp_logfile: /var/log/msmtp.log
    • Option C (No logging)

      msmtp_log: "no"
  • Mail aliases

Configure

You can configure your variables in ansible with one of the following

  • Create a variable in host/group variables directory. (recommended)
  • Editing var/main.yml
  • Run ansible-playbook with -e
  • Edit the default/main.yml (not recommended)

Run

By default the mstmp will fail because the configuration uses a bogus smtp server you need to use a valid smtp server

ansible-playbook -l hostname msmtp.yml

Test

You should get a test mail if it works on the root mail

Possible issues

From field requires more work: https://msmtp.sourceforge.net/doc/msmtp.html#Envelope_002dfrom-address

Credits

Initial work on this role was done by ahelal over at AutomationWithAnsible/ansible-msmtp.

About

Ansible role to configure msmtp

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published