IMAPServerInstallInstructions

This document explains how to install Courier_IMAP for Ops.

How to install Courier-IMAP for Ops

Install and configure Courier-IMAP. Edit the following files:

imapd

• MAXDAEMONS=80
• MAXPERIP=60
• IMAP_ACL=1

authdaemonrc

• authmodulelist="authldap"
• LDAPTLS_CACERT=/path/to/your/ca-cert

authldaprc

Set your LDAP servers address and portnumber, example:

LDAP_SERVER             ldap.openprojectservices.org
LDAP_PORT               389

Set the base dn where users can be found, example:

LDAP_BASEDN             ou=Users,dc=ldap,dc=openprojectservices,dc=org

The IMAP server must log onto the LDAP server to be able to verify username and password, set the dn and password used for this, example:

LDAP_BINDDN             uid=auth,ou=Users,dc=ldap,dc=openprojectservices,dc=org
LDAP_BINDPW             verysecret

Set what attribute in LDAP Users contains the email address, example:

LDAP_MAIL               mail

Set what object we will filter user objects in LDAP with, example:

LDAP_FILTER           (objectClass=CourierMailAccount)

Optional: this will be appended to usernames automatically if not logged in with e-mail address, example:

LDAP_DOMAIN             openprojectservices.org

Note: using this setting can cause problems with ACL, an ACL entry set for "guest" does not work for "guest@openprojectservices.org".

Set the UID and GID for the user which can write to the mail folders, the user is usually the SMTP server user. Example:

LDAP_GLOB_UID           postfix
LDAP_GLOB_GID           postdrop

Set the homedir attribute name for users in LDAP, uncertain why this setting is needed, so we just put direct it at the mailbox attribute in LDAP users. Example:

LDAP_HOMEDIR            mailbox

Set the mailbir attribute name for users in LDAP, example:

LDAP_MAILDIR            mailbox

Make sure an encrypted password is used and specify the LDAP attribute in users which contains the password. Example:

#LDAP_CLEARPW           clearPassword
LDAP_CRYPTPW            userPassword

Enable LDAP over TLS. Example:

LDAP_TLS                1

Note: All settings not mentioned here should be left at default.

-- BastiaanGrutters - 14 Oct 2005