dovecot

Table of Contents

1. Overview
2. Module Description
3. Setup
   • What dovecot affects
   • Setup requirements
   • Beginning with dovecot
4. Usage
5. Reference
6. Limitations
7. Development
   • TODO
   • Contributing

Overview

basic dovecot installation

Module Description

This module is intended to be used by eyp-postfix to setup a virtual domains for postfix using SASL authentication. Anyway, it can also be used to configure dovecot as a standalone service but eyp-postfix is a dependency

Setup

What dovecot affects

• package management
• service management
• configuration management:
  • general config file: /etc/dovecot/dovecot.conf
  • local usernames (default: /etc/dovecot/passwd)

Setup Requirements

This module requires pluginsync enabled.

dovecot::mail_location is a prerequisite to be able to deploy dovecot

Beginning with dovecot

basic setup (dovecot with SASL authentication using a file to store passwords):

class { 'dovecot': }
class { 'dovecot::userdb': }
class { 'dovecot::passdb': }
class { 'dovecot::auth': }
class { 'dovecot::auth::unixlistener': }
class { 'dovecot::imaplogin': }

dovecot::account { 'demo@demo.systemadmin.es':
  password => 'demopassw0rd',
}

Usage

Right now does not support may options, it's intended to be in a small MTA server (for example, does not support LDAP auth)

Reference

classes

dovecot

docvecot installation and basic configuration:

• manage_package: = true,
• package_ensure: = 'installed',
• manage_service: = true,
• manage_docker_service: = true,
• service_ensure: = 'running',
• service_enable: = true,
• listen: = [ * ],
• login_greeting: = 'ready to rock',
• verbose_proctitle: = true,
• shutdown_clients: = true,
• protocols: = [ 'imap', 'lmtp' ],
• disable_plaintext_auth: = false,
• auth_mechanisms: = [ 'plain', 'login' ],
• mail_access_groups: = 'postfix',
• default_login_user: = 'postfix',
• first_valid_uid: = $dovecot::params::postfix_username_uid_default,
• first_valid_gid: = $dovecot::params::postfix_username_gid_default,
• mail_location: = 'maildir:/var/vmail/%d/%n',
• ssl: = false,
• base_dir: = '/var/run/dovecot/',
• imap_idle_notify_interval_minutes: = '2',

dovecot::auth

service auth:

• user: (default: root)

dovecot::auth::unixlistener

• user: = $dovecot::default_login_user,
• group: = $dovecot::mail_access_groups,
• mode: = '0660',
• socket: = 'auth-client',

dovecot::imaplogin

• process_min_avail: = $::processorcount,
• user: = $dovecot::default_login_user,

dovecot::passdb

• driver: = 'passwd-file',
• scheme: = 'SHA1',
• passwdfile: = $dovecot::params::passwdfile_default,

dovecot::userdb

• driver: = 'static',
• uid: = $dovecot::params::postfix_username_uid_default,
• gid: = $dovecot::params::postfix_username_gid_default,
• home: = '/var/vmail/%d/%n',
• allow_all_users: = true,

defines

dovecot::account

• password:,
• account: = $name,
• passwdfile: = $dovecot::params::passwdfile_default,
• password_scheme: = 'sha1',

Limitations

Tested on:

• CentOS 6
• CentOS 7
• Ubuntu 14.04
• Ubuntu 16.04

Development

We are pushing to have acceptance testing in place, so any new feature should have some test to check both presence and absence of any feature

TODO

• lots of dovecot functionalities still needs to be implemented in this module

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request