aboutsummaryrefslogtreecommitdiffstats
path: root/roles/postfix_client/README.md
blob: 1eaf5cb782a33e485d75a9f297a66938604684c3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
Postfix Client
==============

Description
-----------

The `postfix_client` role installs [Postfix](https://www.postfix.org/) as the
local mail transfer agent, and configures it to relay all mail to a given STMP
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
````