README.md 1.09 KB
Newer Older
Raphaël Pinson's avatar
Update  
Raphaël Pinson committed
1
# Postfix Puppet Module
2

Raphaël Pinson's avatar
Raphaël Pinson committed
3
[![Puppet Forge](http://img.shields.io/puppetforge/v/camptocamp/postfix.svg)](https://forge.puppetlabs.com/camptocamp/postfix)
Raphaël Pinson's avatar
Update  
Raphaël Pinson committed
4
[![Build Status](https://img.shields.io/travis/camptocamp/puppet-postfix/master.svg)](https://travis-ci.org/camptocamp/puppet-postfix)
5

Raphaël Pinson's avatar
Raphaël Pinson committed
6 7
This module requires Augeas.

8 9 10 11 12 13
## Simple usage

    include postfix

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

Simon Séhier's avatar
Simon Séhier committed
14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
## Exec paths

In order to not have any path problem, you should add the following line in
some globally included .pp file:

    Exec {
      path => '/some/relevant/path:/some/other:...',
    }

For example:

    Exec {
      path => '/bin:/sbin:/usr/sbin:/usr/bin',
    }

29 30
## Classes

Raphaël Pinson's avatar
Doc  
Raphaël Pinson committed
31 32 33
### postfix

The top-level class, to install and configure Postfix.
34 35 36

## Definitions

Raphaël Pinson's avatar
Doc  
Raphaël Pinson committed
37 38 39 40 41 42 43 44 45 46 47 48 49 50 51
### postfix::config

Add/alter/remove options in Postfix main configuration file (main.cf)

### postfix::hash

Creates Postfix hashed "map" files, and build the corresponding db file.

### postfix::transport

Manages content in the transport map.

### postfix::virtual

Manages content in the virtual map.
52 53