ansible-role-postfix/README.md

75 lines
1.9 KiB
Markdown

# postfix
## Parameters and defaults
All configuration is to be placed inside the `postfix` and `postfixmaps` dicts.
## LDAP
This role supports LDAP as configuration source for:
* TODO: finish list
Note that only ldap**s** connections are supported.
**postfix**
```
# SSL settings
ssl:
# path to ssl key
key: /etc/ssl/private/ssl-cert-snakeoil.key
# path to ssl cert with chain
cert: /etc/ssl/certs/ssl-cert-snakeoil.pem
# For this settings see http://www.postfix.org/postconf.5.html#smtpd_tls_security_level
# but normaly there is no reason to change it from "may"
# Please not this settings apply to smtp only, not to submission
outgoing_security_level: may
incoming_security_level: may
# Enable opendkim integration
enable_opendkim: false
# Enable the submission port (needed to send mail by clients)
enable_submission: false
# Size limit of messages in bytes, default is ~20MB
message_size_limit: 20480000
# See http://www.postfix.org/postconf.5.html#relay_transport
# normaly you do not need to change this
relay_transport: smtp
# See http://www.postfix.org/postconf.5.html#relayhost
# only set if this host should be a relay
relayhost: ''
# See http://www.postfix.org/postconf.5.html#relay_domains
relay_domains: []
# See http://www.postfix.org/postconf.5.html#sender_dependent_relayhost_maps
# If set, this should point to a file which is a postfixmap
sender_dependent_relayhost_maps: ''
# See http://www.postfix.org/postconf.5.html#virtual_alias_maps
# Maps mail addresses to user
virtual_alias_maps: ''
# list of domains we have mailboxes for, see http://www.postfix.org/postconf.5.html#virtual_mailbox_domains
virtual_mailbox_domains: []
# networks to relay mail from without user authentication
mynetworks: []
# currently ignored
mydestination: []
```
**postfixmaps**
```
# Should be '<path>': *mapddict*
# for Example:
postfixmaps:
"/etc/postfix/virtual":
```