Initial commit

README.md

@@ -0,0 +1,27 @@
+# Ansible Postfix role
+This role is an easy way of configuring outgoing mail for local users. It's
+intended to be used by local users only, for example, to receive mail from
+cronjobs. 
+
+An aliases file is set up along with Postfix, where all email is forwarded to
+the current Ansible user. Those emails are then forwarded to an external email
+address. If you need to set up a more complex aliases file, you'll need to edit
+the file manually.
+
+## Example usage in a playbook
+
+```
+- hosts: vm1.home.lan
+  become: yes
+  vars:
+    mail_hostname: vm1.home.lan
+    canonical_name: vm1.home.example.com
+    external_email_address: jackbenny@example.com
+    relay_host: email-smtp.eu-west-1.amazonaws.com
+    relay_port: 465
+    relay_user: xxx
+    relay_password: yyy
+    
+  roles:
+    - jackbenny.postfix
+```