puppet-dovecot's Introduction

dovecot

A fork of https://github.com/mxhero/puppet-dovecot.

Module Description - What the module does and why it is useful
Setup - The basics of getting started with dovecot
- What dovecot affects
Usage - Configuration options and additional functionality
Limitations

Module Description

The dovecot module lets you use Puppet to manage the Dovecot IMAP server. This module is developed and tested on Debian 8 but will most likely be compatible with Debian-like distributions.

Setup

What dovecot affects

Your system's dovecot/dovecot.conf file.
Your system's dovecot/conf.d/ directory

Usage

dovecot : Main class
dovecot::file : Definition to manage configuration file snippets
dovecot::plugin : Definition to install plugin sub-packages

Example Configuration

class { 'dovecot':
    plugins                    => [ 'mysql', 'pigeonhole' ],
    protocols                  => 'imap pop3 sieve',
    verbose_proctitle          => 'yes',
    auth_include               => 'sql',
    mail_location              => 'maildir:~/Maildir',
    auth_listener_userdb_mode  => '0660',
    auth_listener_userdb_group => 'vmail',
    auth_listener_postfix      => true,
    ssl_cert                   => '/etc/dovecot/dovecot.pem',
    ssl_key                    => '/etc/dovecot/private/dovecot.pem',
    postmaster_address         => '[email protected]',
    hostname                   => 'mail.example.com',
    lda_mail_plugins           => '$mail_plugins sieve',
    auth_sql_userdb_static     => 'uid=vmail gid=vmail home=/home/vmail/%d/%n',
    log_timestamp              => '"%Y-%m-%d %H:%M:%S "',
}

dovecot::file { 'dovecot-sql.conf.ext':
    source => 'puppet:///modules/example/dovecot-sql.conf.ext',
}

Limitations

The service will only be reloaded on configuration change, meaning that changes requiring a full restart won't be applied, such as changes to listening interfaces.

Recommend Projects