Courier IMAP server

Courier IMAP is the server we need to install so our users can pick up their mail. This package also comes with a POP3 server as well. If you've already picked up the source, you'll need to untar it in the directory we set aside for this project.

Configuring, Compiling and Installing Courier IMAP

You must do the first step - the configuration of the source package as a normal user. Courier IMAP is very explicit about this. If you begin to do this as 'root', you will get a nasty message and you'll have to remove the sources and start all over again. You should also read 00README_NOW_OR_SUFFER, an aptly named file.

First, you should issue this command to configure the source code for the system we're setting up.

./configure --prefix=/usr/local/courier --with-authmysql \
--with-mysql-libs=/usr/lib/mysql/ \
--with-mysql-includes=/usr/include/mysql --with-redhat

We're doing this on a Fedora Core system, so that last option refers to that (FC used to be RedHat).

Now you can switch to the root user for these last two commands:

make install

and

make install-configure

Courier IMAP configuration

One of the files created is called 'authmysqlrc' and can be found in /usr/local/courier/etc/. Make sure the following lines are in this file.

MYSQL_SERVER localhost
MYSQL_USERNAME postfix
MYSQL_PASSWORD XXXXXXX
MYSQL_PORT 0
MYSQL_DATABASE postfix
MYSQL_USER_TABLE postfix_users
MYSQL_CLEAR_PWFIELD clear
MYSQL_UID_FIELD uid
MYSQL_GID_FIELD gid
MYSQL_LOGIN_FIELD email
MYSQL_HOME_FIELD homedir
MYSQL_MAILDIR_FIELD maildir
MYSQL_QUOTA_FIELD quota

It's very important that there is NO WHITE SPACE after these values. If authentication isn't working when you try to pick up mail, this may be the problem. Check for white space and tail your /var/mysql.log file to see what values MySQL is looking for. Be particularly careful with 'MYSQL_USERNAME' and 'MYSQL_PASSWORD'

The other file we need to modify is: /usr/local/courier/etc/authdaemonrc Make sure it contains the following line:

authmodulelist="authmysql authpam"

Finally, we need to make two more small changes to two files. Find /usr/local/courier/etc/imapd and change the following line:

IMAPDSTART=YES

Then change /usr/local/courier/etc/pop3d

POP3DSTART=YES

That's the Courier IMAP setup.