# Cyrus IMAP Server Release Information

IMAP (Internet Message Access Protocol) is an Internet standards-track protocol for accessing messages (mail, bboards, news, etc). The Cyrus IMAP server differs from other IMAP server implementations in that it is generally intended to be run on "sealed" servers, where normal users are not permitted to log in. The mailbox database is stored in parts of the filesystem that are private to the Cyrus IMAP system. All user access to mail is through the IMAP, NNTP, POP3, or KPOP protocols.

The private mailbox database design gives the server large advantages in efficiency, scalability, and administratability. Multiple concurrent read/write connections to the same mailbox are permitted. The server supports access control lists on mailboxes and storage quotas on mailbox hierarchies.

## Features

The Cyrus server supports the IMAP4rev1 protocol described in RFC 3501. IMAP4rev1 has been approved as a proposed standard.

Character sets supported for searching are: us-ascii, iso-8859-1, iso-8859-2, iso-8859-3, iso-8859-4, iso-8859-5, iso-8859-6, iso-8859-7, iso-8859-8, iso-8859-9, koi8-r, iso-2022-jp, iso-2022-kr, gb2312, big5, iso-8859-15, windows-1252, windows-1256. The character mapping tables most likely contain errors.

The server supports any authentication mechanism available from the SASL library. Currently, support includes: KERBEROS_V4, GSSAPI, CRAM-MD5, DIGEST-MD5, OTP, PLAIN, and STARTTLS.

The server supports imaps/pop3s/nntps (IMAP/POP3/NNTP encrypted using SSL).

The server makes an attempt to do single instance store where possible when an email message is addressed to multiple recipients.

We current support the following IMAP capabilities: `IMAP4 IMAP4rev1 ACL RIGHTS=kxte QUOTA LITERAL+ NAMESPACE UIDPLUS ID NO_ATOMIC_RENAME UNSELECT CHILDREN MULTIAPPEND SORT SORT=MODSEQ THREAD=ORDEREDSUBJECT THREAD=REFERENCES ANNOTATEMORE CATENATE CONDSTORE URLAUTH IDLE STARTTLS SASL-IR`.

The server supports SIEVE for server side email filtering.

## Upgrade Caveats

This section reserved for WARNING WARNING WARNING comments.
Note that the replication protocol currently does not have the facility to support the IMAP CONDSTORE extension (modification sequences). It is recommended that you do not try to use both CONDSTORE and replication at this time. The deficiencies in the replication protocol will be fixed in version 2.3.9.

## Installation Overview

This system should be expected to have the same order-of-magnitude installation complexity as a netnews system. Maintenance should have similar complexity, except administrators will have to deal with creation and deletion of users and will have the option of managing quotas and access control lists.

This package is distributed as a source only release. It is expected that you can compile and configure software. Installation instructions are in the install.html. Please be sure to read this document.

A detailed overview of the server is available in overview.html.

This server has been successfully installed on a number of Unix systems. We run the software under SPARC Solaris 8. Please refer to os.html for operating system specific issues.

## Server Notes

The mailbox namespace is like that for netnews--hierarchical names separated by the "`.`" character. Mailboxes without a parent may only be created by an administrator. Mailboxes with a parent may be created as the ACL (Access Control List) on the parent mailbox permits.

Users' personal mailboxes are under the "`user`" hierarchy. The names of the personal mailboxes for user "`bovik`" all start with the prefix "`user.bovik.`". The mailbox "`user.bovik`" is special in that it is presented to user "`bovik`" as if it were named "`INBOX`". Creating the mailbox "`user.bovik`" is equivalent to creating an account for user "`bovik`"--it permits "`bovik`" to receive mail, create personal mailboxes, and subscribe to mailboxes. Deleting the mailbox "`user.bovik`" has the special-case side-effect of deleting all mailboxes starting with "`user.bovik.`" and of deleting the subscriptions for "`bovik`."

## Licensing Information

The following copyright applies to the code:

     * Copyright (c) 1994-2000 Carnegie Mellon University.  All rights reserved.
     *
     * Redistribution and use in source and binary forms, with or without
     * modification, are permitted provided that the following conditions
     * are met:
     *
     * 1. Redistributions of source code must retain the above copyright
     *    notice, this list of conditions and the following disclaimer.
     *
     * 2. Redistributions in binary form must reproduce the above copyright
     *    notice, this list of conditions and the following disclaimer in
     *    the documentation and/or other materials provided with the
     *    distribution.
     *
     * 3. The name "Carnegie Mellon University" must not be used to
     *    endorse or promote products derived from this software without
     *    prior written permission. For permission or any legal
     *    details, please contact
     *	Office of Technology Transfer
     *	Carnegie Mellon University
     *	5000 Forbes Avenue
     *	Pittsburgh, PA  15213-3890
     *	(412) 268-4387, fax: (412) 268-7395
     *	tech-transfer@andrew.cmu.edu
     *
     * 4. Redistributions of any form whatsoever must retain the following
     *    acknowledgment:
     *    "This product includes software developed by Computing Services
     *     at Carnegie Mellon University (http://www.cmu.edu/computing/)."
     *
     * CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO
     * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
     * AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE
     * FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
     * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
     * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
     * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

If you find this software useful and valuable in your work, we would welcome any support you can offer toward continuing this work. We gratefully accept contributions, whether intellectual or monetary. Intellectual contributions in the form of code or constructive collaboration can be directed via the feedback page.

If you wish to provide financial support to the Cyrus Project, send a check payable to "Carnegie Mellon University" to

          Project Cyrus
          Computing Services
          Carnegie Mellon University
          5000 Forbes Ave
          Pittsburgh, PA 15213
          USA

## Summary

If you want to install the server, be sure to read the installation instructions in install.html.

More details about the server implementation is in the server overview document.

Please refer to Sending Feedback if you would like to submit a bug, feature request or (best of all) patch.

There is a mailing list. See the mailing list document for details.

A list of known problems can be found in the bugs file.

O'Reilly has a book out named Managing IMAP. While the book does not directly talk about the 2.0 code base, it provides very good information on the configuration and setup that can be applied to the newer code.

last modified: 2001/08/03 21:18:05
Return to the Cyrus IMAP Server Home Page