summaryrefslogtreecommitdiff
path: root/README
blob: 19771af6f6d7b5f6461df0674b8b78484cf42f3a (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
= Postfix Puppet module

This module will help install and configure postfix.

A couple of classes will preconfigure postfix for common needs.

Config
------
- set $postfix_use_amavisd="yes" to include postfix::amavis
- set $postfix_anon_sasl="yes" to hide the originating IP in email
  relayed for an authenticated SASL client; this needs Postfix
  2.3 or later to work; beware! Postfix logs the header replacement
  has been done, which means that you are storing this information,
  unless you are anonymizing your logs.
- set $postfix_manage_header_checks="yes" to manage header checks (see
  postfix::header_checks for details)
- set $postfix_manage_transport_regexp="yes" to manage header checks (see
  postfix::transport_regexp for details)
- set $postfix_manage_virtual_regexp="yes" to manage header checks (see
  postfix::virtual_regexp for details)
- set $postfix_manage_tls_policy="yes" to manage TLS policy (see
  postfix::tlspolicy for details)
- by default, postfix will bind to all interfaces, but sometimes you don't want
  that. To bind to specific interfaces, use the $postfix_inet_interfaces
  variable and set it to exactly what would be in the main.cf file.
- some hosts have weird-looking host names (dedicated servers and VPSes). To
  set the server's domain of origin, set the $postfix_myorigin value

== Example:

  include postfix

  postfix::config { "relay_domains": value  => "localhost host.foo.com" }