Go to file
Unknown 3c17537de5 Update meta and readme 2018-05-07 22:28:10 +08:00
defaults Remove MTAs optional 2018-05-07 22:26:30 +08:00
handlers Add real email account for testmails. Run playbook verbose. 2018-05-07 17:53:56 +08:00
meta Update meta and readme 2018-05-07 22:28:10 +08:00
tasks Remove MTAs optional 2018-05-07 22:26:30 +08:00
templates Edit comments 2018-05-07 16:31:19 +08:00
tests Remove other MTAs in Vagrant tests 2018-05-07 22:27:35 +08:00
vars First commit 2014-03-21 20:16:55 +01:00
.gitignore Update gitignore 2018-05-07 16:28:48 +08:00
.travis.yml Add real email account for testmails. Run playbook verbose. 2018-05-07 17:53:56 +08:00
LICENSE Update meta and readme 2018-05-07 22:28:10 +08:00
README.md Update meta and readme 2018-05-07 22:28:10 +08:00
Vagrantfile Add Ubuntu 2018-05-07 19:29:15 +08:00

README.md

Build Status

chriswayg.msmtp-mailer

This ansible role deploys msmtp for Debian / Ubuntu.

Prerequisite

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

How to install

  • Use github to clone/fork into your role directory
  • ansible galaxy ansible-galaxy install chriswayg.msmtp-mailer

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 accounts:

    msmtp_accounts:
    - account  : gmail
      host     : smtp.gmail.com
      port     : 587
      auth     : "on"
      from     : example@gmail.example
      user     : example@gmail.example
      password : "some password"
    - account  : mysmtp
      host     : smtp.example
      port     : 587
      auth     : "on"
      from     : admin@example.org
      user     : myuser@example.org
      password : plain-text-password2
    
  • msmtp_default_account: Default smtp account to use

    msmtp_default_account: "gmail"

  • 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

    • msmtp_alias_default: default email this required

      msmtp_alias_default : ops@example.com

    • msmtp_alias_root: root email this is optional

      msmtp_alias_root : root@example.com

    • msmtp_alias_cron: cron email this optional

      msmtp_alias_cron : cron@example.com

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 mstmp will work as the configuration uses a real smtp server (for testing only!)

ansible-playbook -l hostname msmtp.yml

Test

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

Documentation

msmtp manual