USER AUTHENTICATION

This rpm has been configured to use saslauthd as the authentication method,
so you should configure saslauthd (/etc/sysconfig/saslauth) and start it (a
standard rc script is provided with cyrus-sasl). In its default configuration
saslauthd will use pam for auhentication.
You can edit /etc/imapd.conf to use something else instead of saslauthd.
See the documentation for cyrus-imapd (specifically the install-auth.html
file) and the documentation for cyrus-sasl.


POSTFIX CONFIGURATION

There are many possible way to configure postfix to deliver mail to cyrus.
The recommended way is to use the lmtp protocol to talk to the cyrus lmtpd
unix socket or tcp socket. The proposed configurations are only intended as 
a starting point, please read the documentation if you need more advanced
features (e.g. single instance store).

1) simple configuration

if you're not worried that any user in group mail can talk to the lmtp
socket you can use this configuration:

  1.a) leave /etc/cyrus.conf as delivered by default with an uncommented 
       line that reads
       
         lmtpunix cmd="lmtpd" listen="/var/lib/imap/socket/lmtp" prefork 1

  1.b) edit /etc/postfix/main.cf and add the following line
  
          mailbox_transport = lmtp:unix:/var/lib/imap/socket/lmtp

  1.c) add user postfix to group mail

          gpasswd -a postfix mail

  1.d) ONLY FOR MANDRAKE 9.0
       In mandrake 9.0 postfix comes configured to run lmtp chrooted.
       Edit /etc/postfix/master.cf and modify the "lmtp" line to have
       a "n" in the fifth column:

         lmtp   unix  -   -  n  -  - lmtp

2) secure configuration

if you want only postfix to be able to talk to the lmtp socket you can use
this configuration:

  2.a) create a directory owned by cirus, group postfix,
       with permission 0750, e.g.

          mkdir /var/lib/cyrus_socket
          chown cyrus.postfix /var/lib/cyrus_socket
          chmod 0750 /var/lib/cyrus_socket

       ***NOTE FOR MANDRAKE 9.0*** 
       since mandrake 9.0 comes configured by default to run lmtp chrooted,
       you either have to modify postfix configuration (see 1.d) or put
       the directory under /var/spool/postfix, e.g:
       /var/spool/postfix/cyrus_socket 

  2.b) edit /etc/cyrus.conf and modify the lmtpunix line to use
       a socket in the previously created directory

          lmtpunix cmd="lmtpd" listen="/var/lib/cyrus_socket/lmtp" prefork 1

  2.c) edit /etc/postfix/main.cf and add the following line
  
          mailbox_transport = lmtp:unix:/var/lib/cyrus_socket/lmtp
       
       In case you're using mandrake 9.0 and lmtp is running chrooted
       specify a relative path, e.g. if the socket is in 

          /var/spool/postfix/cyrus_socket 

       use
 
         mailbox_transport = lmtp:unix:cyrus_socket/lmtp

3) flexible and secure

If you want other users besides postfix to access the lmtp socket you can
use a variant of method 2. Just create a directory like in step 2.a for each
user you want to access the lmtp socket and then add a lmtpunix line to
/etc/cyrus.conf for each directory (just be sure to change lmtpunix to
something else, e.g. lmtpunix1, lmtpunix2, etc.)


RPM BUILD TIME CONFIGURATION OPTIONS

This RPM package has been compiled with the following options:

use saslauth group
SASLGROUP: 0

use preforking cyrus.conf
PREFORK: 1

database backends

DUPLICATE_DB: db3_nosync
MBOX_DB: skiplist
SEEN_DB: skiplist
SUBS_DB: flat
TLS_DB: db3_nosync