This documentation is for Dovecot v1.x, see wiki2 for v2.x documentation.

Dovecot as a POP3 server

Dovecot was primarily designed to be an IMAP server, so although it works fine as a POP3 server, it's not really optimized for that.

Maildir Performance

The main problem with Dovecot's POP3 implementation with Maildir is how to get messages' size fast enough. The POP3 specification requires that the sizes are reported exactly, not just approximately. This means that linefeeds must be counted as CR+LF characters. Normally with Maildir the linefeeds are stored as plain LF characters, which means that simply getting the file size would produce the wrong POP3 message size. Some Maildir POP3 servers do this anyway and violate the POP3 specification.

Dovecot returns correct message sizes by reading the entire message and counting the linefeeds correctly. After this is done, the "virtual size" is stored into dovecot.index.cache file and future calculations can be avoided by simply looking up the cached value. Since all of the message sizes are required for each POP3 login, losing the cache files may trigger huge disk I/O bursts.

You can also avoid the initial message size calculation by storing the size directly into the filename. You can do this by appending ,W=<size> at the end of the base filename. For example,W=2211:2, is a file whose virtual size is 2211 bytes (and real size somewhat smaller).

Dovecot v1.1 supports storing virtual sizes also into dovecot-uidlist file. By doing this it doesn't need to create or update dovecot.index.cache file at all for POP3-only users (it internally figures out who POP3-only users are).

mbox Performance

Index files are quite useless if your users don't keep mails in the server. They get first updated when the POP3 session starts to include all the messages, and after the user has deleted all the mails, they again get updated to contain zero mails. With this kind of a session the index reads and writes could have been avoided if the index files had just been completely disabled.

You may want to try how performance changes if you disable indexes for POP3 users. You can also try preserving indexes but try different values for mbox_min_index_size setting.

Session locking

By default Dovecot allows multiple POP3 connections to the same mailbox. This is (was?) especially useful for dialup connections which die in the middle of the download, because the half-dead connections won't keep the mailbox locked.

Setting pop3_lock_session=yes makes Dovecot lock the mailbox for the whole session. This is also what the POP3 RFC specifies that should be done. If another connection comes while the mailbox is locked, Dovecot waits until the locking times out (2 minutes with Maildir, mbox_lock_timeout with mbox). In future there will be a separate pop3_lock_timeout setting which allows timing out sooner.

Flag changes

By default when a message is RETRed, \Seen flag is added to it. POP3 itself doesn't support flags, but if the mailbox is opened with IMAP (eg. from webmail) it's shown as seen. You can disable this (to get better performance) with pop3_no_flag_updates=yes.

POP3 client workarounds

pop3_client_workarounds setting allows you to set some workarounds to avoid POP3 clients breaking with some broken mails.

UIDL format

UIDLs are used by POP3 clients to keep track of what messages they've downloaded, typically only if you've enabled "keep messages in server" option. If the UIDL changes, the existing messages are re-downloaded as new messages, which the users don't really appreciate.

Dovecot supports multiple different ways to set the UIDL format, mostly to make migrations from other POP3 servers transparent by preserving the old UIDL values. See Migration for how to set the UIDLs to be compatible with your previous POP3 server.

For new POP3 servers, the easiest way to set up UIDLs is to use IMAP's UIDVALIDITY and UID values. The default in Dovecot v1.1+ is:

pop3_uidl_format = %08Xu%08Xv

Some formats, such as the previous default %v.%u, seem to have problems with Outlook 2003.

MD5 UIDL format

Note: This works only with mbox format and there are some issues with it with Dovecot versions earlier than v1.0.1.

pop3_uidl_format = %m

This works by getting the MD5 sum of a couple of message headers that uniquely identify the message. The one good thing about MD5 format is that it doesn't rely on the IMAP UID or UIDVALIDITY value. This allows you to modify the mbox files in ways that Dovecot doesn't like, without causing the UIDLs to change. For example:

The MD5 summing method however doesn't work well if you receive two identical messages. Usually the MD5 sum is taken from these headers:

Normally there won't be a problem, because the MTA adds a unique identifier to the first Received: header. If the same message is sent to multiple users in one delivery, the Delivered-To: header is still different, making the MD5 sum different.

Except the MTA can be configured to support aliases, so for example sending the mail to both root@ and webmail@ aliases causes the message to be delivered to the same user, with identical Received: and Delivered-To: headers. The messages really are identical, so their MD5 sums are also identical, and that can cause some POP3 clients to keep downloading the messages over and over again, never deleting them.

To avoid this, there's also a 3rd header that is included in the MD5 sum calculation:

If you use Dovecot's deliver or IMAP APPEND and pop3_uidl_format = %m, it always appends the X-Delivery-ID: header to saved mailbox. Any existing X-Delivery-ID: headers in the saved mails are dropped.

POP3Server (last edited 2009-03-15 22:35:23 by localhost)