Getting started

Default setup

If you don’t specify any configuration values, the role will setup an IMAP and IMAPS service using the certificates provided by ansible-pki. It will further use the ansible-ferm role to open the required network ports with iptables: 143 (IMAP+STARTTLS) and 993 (IMAPS). Every user account which is able to login via PAM, can then also login via IMAP and access its mails stored as an mbox file in /var/mail/<username>.

Example inventory

You can install Dovecot on a host by adding it to the [debops_dovecot] group in your Ansible inventory:


Example playbook

Here’s an example playbook which uses debops.dovecot role to install Dovecot:


- name: Setup Dovecot IMAP Server
  hosts: debops_dovecot

    - role: debops.dovecot
      tags: dovecot