CONFIGURING SENDMAIL FOR CYRUS
==============================

You have two options:

(1) As a full replacement for your local mail system; in this case you will
no longer be able to use elm, pine etc. unless you configure them for IMAP,
because no mail will be delivered to /var/spool/mail/<user>

define(`CYRUS_MAILER_FLAGS',`A5@S')
define(`confLOCAL_MAILER',`cyrus')
mailer(cyrus)

LOCAL_RULE_0
Rbb + $+ < @ $=w . >    $#cyrusbb $: $1

[This last rule allows bb+mailbox@yourdomain to deliver to the named global
mailbox; bb refers to 'bulletin board']

Remove FEATURE(local_procmail) if it exists, or comment it out by putting
'dnl' at the beginning of the line.

(2) As an additional domain, e.g. so that user@imap.your.domain is delivered
into the cyrus mail area.

Create a mailertable (if you don't already have one) in /etc/mailertable,
containing the following line:

imap.your.domain	cyrus:inbox

Then build it like this:

makemap hash /etc/mailertable </etc/mailertable

Your m4 config file needs to contain the following:

FEATURE(mailertable)
define(`CYRUS_MAILER_FLAGS',`S')
mailer(cyrus)

Finally, point an MX record for imap.your.domain pointing to your machine.
Note that users in this domain still need to have entries in /etc/passwd,
otherwise there would be no passwords to authenticate against when reading
their mail. This limitation will go when someone integrates PAM support into
Cyrus.

CREATING MAILBOXES
==================

Add the usernames of the administrator user(s) to /etc/imapd.conf, separated
with spaces, e.g.

    admins: curtj abell

Then start the cyradm tool:

# cyradm localhost

Login using the username and password of one of the admin users. Type 'help'
for a list of commands.

    To create a mailbox, type:

       createmailbox user.<userid>

    For example, to create a mailbox for the userid "smith", type:

       createmailbox user.smith

    To limit "smith" to 10,000 kilobytes of mail, type:

       setquota user.smith 10000

    Once the inbox is created, users can create their own additional
    mailboxes from a mail program. If Smith created a work mailbox and a
    play mailbox, the full names of the mailboxes would be:

       user.smith.work
       user.smith.play

    Access rights are discussed in detail in the cyradm(1) man pages. Note
    that the administrator must grant herself delete access explicitly
    before she can delete a mailbox:

       setaclmailbox <mail_box> <admin_userid> d
       deletemailbox <mail_box>

    Once you have created mailboxes, your IMAP server installation is done.

CONFIGURING FOR ACCESS TO A NEWS SPOOL
======================================

See doc/install for details; I've not tried this myself

COMMON PROBLEMS
===============

If you see error messages about /var/imap/delivered.db, or the deliver
program segfaults, then just 'rm /var/imap/delivered.db' and it will be
recreated automatically.

This database is an optimisation which prevents duplicate copies of messages
(with the same Message-ID) being delivered into mailboxes. This feature can
be disabled by removing the '-e' flag from deliver:

define(`CYRUS_MAILER_ARGS', `deliver -m $h -- $u')
define(`CYRUS_BB_MAILER_ARGS', `deliver -m $u')
