Home »

Cyrus2Dovecot

Overview

Cyrus2Dovecot is a full-featured command line tool for converting the e-mails of one or more users from Cyrus format to Dovecot Maildir ++ folders. It allows for performing a server transition which is fully transparent to both POP and IMAP users. For details, see the feature list below, as well as the manual page (which also includes usage examples).

Features

All e-mail folders of a Cyrus user are automagically converted into a Maildir++ directory structure with appropriate subdirectories.
Virtually all available metadata is preserved during the conversion. This includes the UID and INTERNALDATE of each message, the IMAP folder subscriptions, the UIDVALIDITY and UIDNEXT values for each folder, as well as all IMAP flags (i.e., \Recent, \Seen, \Answered, \Flagged, \Draft, \Deleted), and the first 26 user-defined keywords.
Optionally, Maildir++ “maildirsize” files are created, either with the same quota limits as in Cyrus or using a new default quota limit specified on the command line.
Cyrus' seen and subscription databases may be present either in the “skiplist” format or as “flat” text files, and Cyrus' quota databases (if any) may be present either in one of these formats or as “quotalegacy” files, since Cyrus2Dovecot supports those formats out of the box. Berkeley databases can be converted to one of the supported formats using cvt_cyrusdb(8).
The generated e-mail filenames include the Maildir++ extensions S=<size> and W=<vsize> (which are used by Dovecot for better performance).
If necessary, IMAP folders can easily be renamed (or moved around) by matching and substituting their names using regular expressions during the conversion.
Arbitrarily large numbers of e-mails, folders, and users are handled just fine.
Cyrus2Dovecot is written in Perl.

Compatibility

Cyrus2Dovecot is supposed to work with all Cyrus releases up to (at least) version 2.3.x. So far, it has been tested with Cyrus 1.4, 2.1.18, 2.2.12, and 2.3.12p2.

Author

This software was developed by Holger Weiß at Freie Universität Berlin, Germany, Zentraleinrichtung für Datenverarbeitung (ZEDAT).

Copyright and License

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic(1). This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.