User Tools

Site Tools


build:imap

This is an old revision of the document!


Courier IMAP

We chose Courier IMAP as our mail access agent (MAA) because it is easy to configure and maintain. It supports the IMAP4 and POP3 protocols, allowing mail user agents (MUAs) to get their email from the mail server. As the name suggests, IMAP is the primary protocol. IMAP has many advantages over POP; chief among them is support for folders, and keeping the emails on the server.

TODO: Jeff Muse and Craig Buchek think we should move to Courier IMAP, as it's much easier to configure and maintain. Plus, there's good documentation on setting it up to work with Postfix at http://workaround.org/articles/ispmail-sarge.

(See this article for a description of all the pieces involved in email delivery.)

Installation

We need to install several pieces of the Courier email system. First, some pre-requisites:

apt-get install libfam0c102 courier-base courier-ssl courier-authdaemon

When asked if you want to use configuration directories, answer Yes.

Install the IMAP pieces, and the POP pieces:

apt-get install courier-imap courier-imap-ssl
apt-get install courier-pop courier-pop-ssl

Install the recommended packages and documentation:

apt-get install courier-doc

TODO: Don't forget to create /etc/courier/pop3d.pem and /etc/courier/imapd.pem SSL certificates. TODO: Need to install on Budlight. TODO: Hook Postfix to deliver to Maildirs where Courier can pick it up. TODO: Test.

Cyrus IMAP (OLD)

We chose Cyrus IMAP as our mail access agent (MAA). It supports the IMAP4, POP3, and KPOP protocols, allowing mail user agents (MUAs) to get their email from the mail server. As the name suggests, IMAP is the primary protocol. IMAP has many advantages over POP; chief among them is support for folders, and keeping the emails on the server.

TODO: Jeff Muse and Craig Buchek think we should move to Courier IMAP, as it's much easier to configure and maintain. Plus, there's good documentation on setting it up to work with Postfix at http://workaround.org/articles/ispmail-sarge.

(See this article for a description of all the pieces involved in email delivery.)

Installation

We are using Cyrus IMAP version 2.1.17, thus you need to install the following packages:

  • cyrus21-imapd
  • cyrus21-pop3d
  • cyrus21-admin
  • cyrus21-client
  • cyrus21-common
  • cyrus21-doc (optional, but highly recommended)

To manage user accounts, install the mailadmin package (you can get the Debianized version from the Sudora private repository, or download the tarball and manually install from the mailadmin site). This program requires PostgreSQL, PHP (php4-imap with register_global on in /etc/php4/apache/php.ini) and apache-ssl (highly recommended for security purposes).

Certificates were made using the ssl-cert packages make-ssl-cert script. We had to edit the /usr/sbin/make-ssl-cert script and add the -days 3650 to the openssl command that actually creates the certificate, otherwise it defaults to 30 days (have not yet figured this one out).

Sieve is a server side mail filtering capability (similiar to procmail) that Cyrus implements. The smartsieve package will need to be installed to allow the user to manage their sieve rules via a web interface. Sieve is only usable when you retrieve your e-mail via IMAP, since POP3 does not support sub-folders.

Configuration

TODO

  • Document configuration details.
  • Make sure IMAP isn't filling up the log files again. It was giving us errors like this, because OpenSSL wasn't configured correctly:

Mar 6 15:08:58 budlight cyrus/imapd[8947]: Fatal error: imaps: required OpenSSL options not present

Mar  6 15:08:59 budlight cyrus/pop3d[8950]: pop3s: required OpenSSL options not present
Mar  6 15:09:01 budlight cyrus/imapd[8951]: imaps: required OpenSSL options not present
Mar  6 15:09:02 budlight cyrus/imapd[8951]: Fatal error: imaps: required OpenSSL options not present
Mar  6 15:09:04 budlight cyrus/imapd[8954]: imaps: required OpenSSL options not present
  • Document why we chose Cyrus over Courier IMAP and UW-IMAP.
  • Review cyrus at thornhill library (do not delete)
  • Install/configure mailadmin (or just use the command-line cyradm) and smartsieve packages.

Alternative IMAP Servers

build/imap.1131152025.txt.gz · Last modified: 2006/03/18 16:03 (external edit)