3.1 From scratch

• Get the source for courier-auth-postfix from http://www.commedia.it/ccontavalli/#AuthPfix
• Untar it somewhere on your hard drive with something like:

    $ gzip -cd courier_authpostfix.tar.gz | tar -xv
  

• Get the source of postfix from www.postfix.org
• Untar it somewhere on your hard drive with something like:

    $ gzip -cd postfix-x.x.x.tar.gz | tar -xv
  

• Ok, now you need to do 2 things: first, you need to copy authpfix in the postfix tree, second, you need to tell postfix to compile courier-auth-postfix. So, let's start from the first step...

    $ cp -a courier_authpostfix/authpfix postfix-x.x.x/src
  

• Now, you need to change postfix-x.x.x/Makefile.in in order to make the line that looks like

    DIRS    = src/util src/global src/dns src/master src/postfix src/smtpstone \
  

  to look like

    DIRS    = src/util src/global src/authpfix src/dns src/master src/postfix src/smtpstone \
  

  (Note the additional src/authpfix) That way, you tell postfix makefiles to build authpfix right after src/util and src/global.
• Follow the instructions provided with postfix to compile postfix

  Whatch out! there are still some problems with library dependencies in the authpfix makefile. If you experience troubles compiling the module, please send me a mail with the output of make.

• You should end up with two additional files in postfix-x.x.x/bin: authpostfix and authcleanup.
• Copy authcleanup in /usr/sbin while put authpostfix in courier authentication modules directory (depends on your distribution and os). It should be somewhere in /usr (in debian is /usr/lib/courier/authlib) and you can probably find it with something like:

    $ locate auth | grep ^/usr | grep courier
  

  or using the ``libexecdir'' parameter printed by

    $ courier-config 
  

  No special rights are needed (0755 should be good for both, with root:root as owner).
• Now, you need to modify the /etc/init.d/pop3d (or courier-pop or whatever) script in order to support more configuration parameters by changing:

  /usr/bin/env - PATH="$PATH" SHELL="$SHELL" POP3AUTH="$POP3AUTH" \
                 $TCPD -pid=$PIDFILE -stderrlogger=${sbindir}/courierlogger \
                       -maxprocs=$MAXDAEMONS -maxperip=$MAXPERIP \
                 $TCPDOPTS -address=$ADDRESS $PORT \
                 ${prefix}/lib/courier/courier/courierpop3login $AUTHMODULELIST \
                              ${prefix}/lib/courier/courier/courierpop3d Maildir
  

  in something like:

  /usr/bin/env - LOGINDB="$LOGINDB" PATH="...and so on
  

  Note, however, that this file may be different from system to sytem.
• Edit courier-auth-postfix.cron you can find in courier_authpostfix/authpfix and modify the name of the database you want to use. The name of the database must follow postfix standards. For example, a valid database name may be: mysql:/etc/postfix/mysql/mysql.dict.

  Look to courier-authpostfix(1) for more details.

• Copy courier-auth-postfix.cron in /etc/cron.d/.
• Now, you can add a new configuration parameter: ``LOGINDB''. You must add this to the courier-imap configuration file (imapd?) and courier-pop configuration file (pop3d?). Its value must be the same database as used with the cron script. For example, you may set ``LOGINDB=mysql:/etc/postfix/mysql/mysql.dict''.
• Add the authpostfix as the last authentication module both in imapd and pop3d. Look the section ``Usage'' for more details.