Installation

This is a regular Python package installable using pip. Obviously, it depends on Python (tested on 3.4+). If you’re feeling adventurous, just run pip install dovecot-userpassdb as root to have everything installed inside /usr/local. If you prefer to keep things tidy and isolated, you can follow these steps instead:

1. Create a Python virtualenv:

   # python -m venv /usr/local/venv-dovecot-userpassdb
   # PIP="/usr/local/venv-dovecot-userpassdb/bin/pip"
   # $PIP install -U pip                                # to be up-to-date

2. Install the dovecot-userpassdb package inside the new virtualenv:

   # $PIP install dovecot-userpassdb

3. Make the newly-installed imap-passwd script available in system PATH:

   # ln -s /usr/local/venv-dovecot-userpassdb/bin/imap-passwd /usr/local/bin

4. Finally, configure Dovecot to use the provided dovecot-checkpass script, for example by including the following block:

   passdb {
       driver = checkpassword
       args = /usr/local/venv-dovecot-userpassdb/bin/dovecot-checkpass
   }