Home
Download
Contribute
Support
Cyrus SASL
Cyrus IMAP
Quickstart Guide
Introduction to Cyrus IMAP
What is IMAP?
Quick install
1. Install Cyrus reference packages
2. Use “apt-get install -f” to complete installation
3. Setup the cyrus:mail user and group
4. Setting up authentication with SASL
5. Setup mail delivery from your MTA
Install Sendmail
Sendmail communication
Install Postfix
6. Protocol ports
7. Configuring Cyrus
8. Launch Cyrus
Feature overview
Download
IMAP Installation Guide
Upgrading
Upgrading to 3.0
Installation Using Packages
CentOS
Debian
Fedora
openSUSE
Red Hat Enterprise Linux
Ubuntu
Build and Install Yourself
Do It Yourself
Optional Components
HTTP modules
External Tools
Licensing
IMAP Release Notes
Currently Stable Version
Current Development Version
Currently Supported Product Series
Series 2.5
Series 2.4
All Versions Going Back Way Back When
Series 1
Series 2: 2.0 - 2.3
Notes for Packagers
Sample configuration files
Predefined configurations
The configuration file for master: cyrus.conf
The configuration file for the various programs: imapd.conf
Services in
/etc/services
Concepts
Features
Security and Authentication
Kerberos Authentication
LDAP Authentication
SQL Authentication
Access Control
Sealed System Design
Mailbox Management
Automatic Creation of Mailboxes
Mailbox Namespaces
Virtual Domains
Mailbox Annotations (METADATA)
Mailbox Distribution
Message Management
Delayed Delete
Delayed Expunge
Message Annotations (METADATA)
Duplicate Message Delivery Suppression
Shared Seen State
Server Side Filtering (Sieve)
Event Notifications
Calendar and Contact (DAV) Collection Management
CalDAV Collections
DAV Components
DAV Collection Management
CardDAV Support
Storage
Mail Spool Partitions
Mailbox Metadata Partitions
Archiving
Quota
Single-Instance Store
Load Management
Cyrus IMAP Murder (Server Aggregation)
Overview
Access Control Lists
Working with ACLs
Sample ACL
Access Rights
Access Control Defaults
Access Control Identifier (ACI)
Negative Rights
Calculating a Users’ Rights
Login Authentication
Anonymous Login
Plaintext Authentication
Kerberos Logins
Shared Secrets Logins
Quotas
Working with Quotas
Monitor and Repair
Supported Quota Types
Quota Roots
Controlling Quota Behavior
Mail Delivery Behavior
Quota Warnings Upon Select When User Has
d
Rights
Quotas and Partitions
New Mail Notification
Partitions
Specifying Partitions with “create”
Changing Partitions with “rename”
News
POP3 Server
The syslog facility
Mail Directory Recovery
Reconstructing Mailbox Directories
Reconstructing the Mailboxes File
Reconstructing Quota Roots
Removing Quota Roots
Subscriptions
Configuration Directory
Log Directory
Proc Directory
Message Delivery
Local Mail Transfer Protocol (lmtp)
Single Instance Store
Duplicate Delivery Suppression
Sieve, a Mail Filtering Language
Cyrus Murder, the IMAP Aggregator
Configuration Guide
Deployment Scenarios
Single Server Deployments
Multi Server Deployments
Cyrus Murder: Server aggregation
The Discrete Murder
The Unified Murder
The Shared Murder
Cyrus Replication
Hosted Environments
Databases
Overview
File list
Storage types
Mailbox Creation Distribution
Selection Mode
Special cases
Partitions Exclusion
Partitions Usage Data Reset
Mailbox Creation Distribution Through
murder
frontend
Backends Exclusion
Backends Usage Data Reset
Known Protocol Limitations
POP3 and Mailbox Locking
Cyrus IMAP POP3 Implementation
Authentication and Authorization
Client Authentication
Users and Mailboxes
Performance Recommendations
Databases on Temporary Filesystems
Storage Considerations
General Notes on Storage
Redundancy
Availability
Performance
Scalability
Capacity
Cost
Supported Platforms and System Requirements
Building Cyrus IMAP
Required Software Components
Recommended Software Components
Recommended Software Components Enabled by Default
Reference
Administrator Guide
Architecture
System Architecture
Management
File & Directory Locations
Ports and Sockets
Access Control
Quotas
Cyrus Sieve
Cyrus Backups
Cyrus NNTP
Cyrus Prot Layer
Standard Operating Procedures
Cyrus Event Source
Mailbox Distribution
Cyrus Murder
HOWTO: Using an NGINX IMAP Proxy
Tweaking Cyrus IMAP
Frequently Asked Questions
Features
Which database backend should I use for which databases?
Duplicate Delivery Suppression
Installation Problems
Compilation errors about kssl.h and krb5.h on Red Hat Linux/Fedora
Problems detecting Berkley DB on Red Hat Linux
Help! There must be an easier way to get all this going...
Common Feature Requests
Does the Cyrus Murder support High Availability configurations?
Can I configure pop3d to log amount and size of messages fetched by user?
How can I make CyrusSieve work with public shared folders?
Can I have subfolders not appear under INBOX?
Common Operational Questions
How do I view ACLs on a mailbox?
What annotations are available?
Why does ctl_cyrusdb -r take so long with Berkeley DB?
Is it safe to put configdir/proc and configdir/lock on a tmpfs filesystem?
How to enable core dumps
Is the “db3: x Lockers” log message harmful?
Why can I not delete a mailbox as an admin user?
When is What ... Deleted, Expired, Expunged or Purged?
Why is deliver.db so large?
I have multiple imapd-SERVICES configured and experience occasional freezes when I try to log in!
Cyrus delivers claims that the mailbox does not exist
Why is mail being rejected with No Mailbox found due to MiXed CaSe incoming e-mail?
Can I use MySQL (or another SQL database) as the primary mail store?
Why do POP3 connections take so long, but once the connection is established all is well?
Why does reconstruct -m not work?
Shared File Systems GPFS for high availability
How to enable telemetry
The process count keeps growing!
“unable to join environment” error
Why does Cyrus set the MAIL FROM address of the sender of vacation responses to ‘<>’?
Common Interoperability Problems
Why does Cyrus reject 8-bit characters in the headers of my messages?
Why does Cyrus reject messages with “bare newlines”?
How do I get Cyrus Sieve to play nice with Exim?
Why does mail delivery go slow or hang sometimes?
Man pages
(5) Configuration Files
cyrus.conf
imapd.conf
krb.equiv
(8) System Commands
arbitron
backupd
chk_cyrus
ctl_backups
ctl_conversationsdb
ctl_cyrusdb
ctl_deliver
ctl_mboxlist
ctl_zoneinfo
cvt_cyrusdb
cvt_xlist_specialuse
cyr_backup
cyr_buildinfo
cyr_dbtool
cyr_deny
cyr_df
cyr_expire
cyr_info
cyr_sequence
cyr_synclog
cyr_userseen
cyr_virusscan
cyradm
cyrdump
deliver
fetchnews
fud
httpd
idled
imapd
ipurge
lmtpd
lmtpproxyd
master
mbexamine
mbpath
mbtool
mkimap
mupdate
nntpd
notifyd
pop3d
pop3proxyd
ptdump
ptexpire
ptloader
quota
reconstruct
restore
rmnews
sievec
sieved
smmapd
squatter
sync_client
sync_reset
sync_server
timsieved
tls_prune
unexpunge
(1) User Commands
dav_reconstruct
httptest
imtest
installsieve
lmtptest
mupdatetest
nntptest
pop3test
sieveshell
sivtest
smtptest
synctest
Work-in-Progress
proxyd
Tools & Utilities
arbitron
arbitronsort.pl
chk_cyrus
convert-sieve.pl
ctl_cyrusdb
ctl_deliver
ctl_mboxlist
cvt_cyrusdb
cvt_cyrusdb_all
cyr_dbtool
cyr_df
cyrdump
cyr_expire
cyr_virusscan
fetchnews
cyr_sequence
cyr_synclog
cyr_userseen
masssievec
mbexamine
mbpath
migrate-metadata
mkimap
mknewsgroups
rehash
translatesieve
undohash
upgradesieve
Developers
Contribute
Website Content Contributions
Contribute Code
IMAP Developer Guide
Getting Started
Development Process
Overview of Cyrus development environment
GitHub guide
Developer Environment Installation
Running a basic server
Developer Test Environment
JMAP support
Contributing to documentation
System files and Databases
Namespaces: a developer view
Resources
Developer Libraries
Releasing
Releasing Cyrus IMAP
Support/Community
Support
Reporting Bugs
Mailing Lists
Archives
Subscribe/Unsubscribe
Digest Lists
IRC Chat
Online Meetings
About
What is Cyrus
What is Cyrus
What is IMAP?
IMAP Version 4 (IMAP4)
Mime
SMTP
Who Is Cyrus
Core Contributors
Individual contributors and past contributors
Cyrus Roadmap
High Level Roadmap
Cyrus History
Cyrus Bylaws
I. The Cyrus Governance Board
II. The Cyrus Core Developers Group
III. The Release Engineer
IV. The Cyrus Roadmap
V. Development Process
VI. Changes to the Bylaws
Cyrus SASL
Cyrus SASL
Cyrus IMAP
Docs v3.0.1 (stable)
»
Download
»
IMAP Installation Guide
»
Supported Mail Transfer Agents
Edit on GitHub
Supported Mail Transfer Agents
ΒΆ
Configuring the MTA