This repository contains instructions and configuration for setting up a kick-ass local Dovecot IMAP server that synchronizes with your remote IMAP server.

These instructions use GMail as a remote IMAP server and assume you're on a Mac, but they can easily be adapted to other platforms and configurations.

• Build and install Dovecot with powerful search/indexing capability enabled
• Use Dovecot's super-efficient mdbox mail storage format
• Use mbsync to keep your local and remote mailboxes in sync.
• Run a daemon that uses IMAP IDLE to be notified of changes to the remote mailbox requiring a sync.

On some platforms (e.g. MacPorts and Homebrew, as of this writing, the official build recipes and packages are not enough to create the system described here. Details below.

If you're using MacPorts, you'll want to set up a local portfile repository. The [instructions](](https://guide.macports.org/chunked/development.local-repositories.html) suggest that you put the repository below your home directory, but that will lead either to great frustration with permissions, or to you unnecessarily relaxing permissions, potentially compromising security.

Adding the following line before the default repository in /opt/local/etc/macports/sources.conf will tell MacPorts to look first in a local repository at /Library/Portfiles/localhost:

file:https:///Library/Portfiles/localhost

I set mine up this way:

sudo mkdir -p /Library/Portfiles/localhost
chown -R "${USER}:everyone" /Library/Portfiles

For my convenience, I also added a symlink as follows (totally optional):

ln -s /opt/local/var/macports/sources/rsync.macports.org/release/tarballs/ports \
   /Library/Portfiles/rsync.macports.org

Then you'll want to copy mail/dovecot2 (), mail/isync, and textproc/libstemmer from my personal Portfile repository to the corresponding locations under /Library/Portfiles/, and then, in that directory, execute

portindex

And finally (anywhere),

sudo port install dovecot2 +lucene +libstemmer
sudo port install isync-devel

For the rest of these instructions, you should read $PREFIX as /opt/local.

Note: MacPorts tickets for the updated Portfiles are here: dovecot, isync, libstemmer

I am not currently using Homebrew for this, but I did create the necessary Formulae at one point:

• dovecot
• libstemmer
• isync

Idle is the feature that notifies us when something changes on the IMAP server. We use it to get timely updates when there are changes.

• You'll need imaplib2. I did sudo easy_install pip and then pip install imaplib2. If you have Growl installed, also pip install gntp and you'll get notifications when new mail arrives. If you're fetishistic about purity, install these in a virtualenv environment.

• In the scripts/ subdirectory of this repository you'll find mbsync-idle-trigger, which monitors Gmail's “[Gmail]/All Mail” folder for changes and initiates a sync whenever something changes there. It also syncs when it starts up, and every 5 minutes thereafter, just in case.

• The script contains several constants at the beginning that you may want to tweak, and one (my GMail username) that you'll definitely want to tweak.