From 44aa00b25daa8bbd23bbd9507f4064e47fab0460 Mon Sep 17 00:00:00 2001
From: Stonewall Jackson <stonewall@sacredheartsc.com>
Date: Thu, 16 Feb 2023 19:49:47 -0500
Subject: postfix_client: add docs

---
 roles/postfix_client/README.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 roles/postfix_client/README.md

(limited to 'roles/postfix_client/README.md')

diff --git a/roles/postfix_client/README.md b/roles/postfix_client/README.md
new file mode 100644
index 0000000..96308ee
--- /dev/null
+++ b/roles/postfix_client/README.md
@@ -0,0 +1,36 @@
+Postfix Client
+==============
+
+Description
+-----------
+
+The `postfix_client` role installs the [Postfix](https://www.postfix.org/)
+as the local mail transfer agent, and configures it to relay all mail to a
+given SMTP server.
+
+
+Variables
+---------
+
+This role **accepts** the following variables:
+
+Variable                     | Default              | Description
+-----------------------------|----------------------|------------
+`postfix_relayhost`          | `{{ email_domain }}` | Next-hop destination for mail delivery (see [documentation](https://www.postfix.org/postconf.5.html#relayhost))
+`postfix_myorigin`           | `{{ email_domain }}` | Default sender domain (see [documentation](https://www.postfix.org/postconf.5.html#myorigin))
+`postfix_message_size_limit` | 67108864             | Maximum message size (bytes)
+
+
+Usage
+-----
+
+Example playbook:
+
+````yaml
+- hosts: all
+  roles:
+    - role: postfix_client
+      vars:
+        postfix_relayhost: '[mx1.example.com]:25'
+        postfix_myorigin: example.com
+````
-- 
cgit