diff options
author | Stonewall Jackson <stonewall@sacredheartsc.com> | 2023-02-16 19:49:47 -0500 |
---|---|---|
committer | Stonewall Jackson <stonewall@sacredheartsc.com> | 2023-02-16 19:49:47 -0500 |
commit | 44aa00b25daa8bbd23bbd9507f4064e47fab0460 (patch) | |
tree | 0b932bf57800d07882a9cce8448ba0276a42e9c8 /roles | |
parent | c0cf8a88f87aecbc1ea35d94b09fa4406038499b (diff) | |
download | selfhosted-44aa00b25daa8bbd23bbd9507f4064e47fab0460.tar.gz selfhosted-44aa00b25daa8bbd23bbd9507f4064e47fab0460.zip |
postfix_client: add docs
Diffstat (limited to 'roles')
-rw-r--r-- | roles/postfix_client/README.md | 36 |
1 files changed, 36 insertions, 0 deletions
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 +```` |