This documentation is for Dovecot v1.x, see wiki2 for v2.x documentation.
Differences between revisions 7 and 42 (spanning 35 versions)
Revision 7 as of 2006-03-03 07:04:26
Size: 2594
Editor: TimoSirainen
Comment:
Revision 42 as of 2011-03-31 07:38:08
Size: 4532
Editor: TimoSirainen
Comment: double despam
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Client Issues =
It seems to be quite difficult to implement a working IMAP client. Here are some instructions for client implementors:
= Client issues and configuration =
It seems to be quite difficult to implement a working IMAP client. [[http://www.imapwiki.org/ClientImplementation|Best Practices for Implementing an IMAP Client]] tries to help you with it.
Line 4: Line 4:
 * [http://dovecot.org/client-commandments.txt Mark Crispin's Ten Commandments of How to Write an IMAP client].
 * [http://dovecot.org/imap-client-coding-howto.html IMAP Client Coding Howto]
<<TableOfContents>>
Line 7: Line 6:
[[TableOfContents]] == Apple Mail.app ==
On Mac OS X Leopard 10.5 Mail.app appears to support subscribe/unsubscribe by right clicking on a mailbox, selecting 'Get Account Info' and selecting 'Subscription List' from tabs. This however doesn't really work with any IMAP server.

Apple Mail 3.6 (that comes with OS X 10.5 Leopard) supports subscribing/unsubscribing to folders in the public namespace.
Line 12: Line 15:
 * Outlook might not hide or purge deleted items by default. Microsoft has a [[http://office.microsoft.com/en-us/outlook/HP100804201033.aspx|how-to that shows how to fix this]] (Outlook 2007, not Outlook 2003).
 * If some Outlook users don't see new or sent mails in the appropriate folders after a migration from UW IMAPd even if they are visible in other clients (e.g. Roundcube, Thunderbird, or on the disk itself), and you get the error message "BAD Error in IMAP command UID: Invalid UID messageset" in the log or rawlog: It helps to remove the problematic IMAP account completely from Outlook and recreating it again there. It speaks a different IMAP afterwards, so there are reasons to believe it caches the details of some server on the first connect and doesn't refresh them even if you change the server's hostname in the account settings.
Line 15: Line 20:
 * You should enable `outlook-idle` and `oe6-fetch-no-newmail` workarounds for IMAP.  * You should enable `outlook-idle` and `delay-newmail` workarounds for IMAP.
Line 27: Line 32:
 * Doesn't support creating subfolders with mbox format.  * Some versions don't support creating subfolders with mbox format. Evolution in Ubuntu Gutsy, 2.12.0-0ubuntu5, does support creating subfolders, at least when the parent folder is empty.
Line 33: Line 38:
 * You should enable `tb-extra-mailbox-sep` workaround for IMAP if you're using mbox. [https://bugzilla.mozilla.org/show_bug.cgi?id=29926 Bug report].  * If you're using [[MailboxFormat/mbox|mbox]], [[MailboxFormat/dbox|dbox]] or [[MailLocation/Maildir#Directory_layout|Maildir]] with `:LAYOUT=fs` ,
  * You should enable `tb-extra-mailbox-sep` workaround for IMAP. [[https://bugzilla.mozilla.org/show_bug.cgi?id=29926|Bug report]].
 * If you're using [[MailboxFormat/mbox|mbox]]:
  * You'll have to disable "Server supports folders that contain sub-folders and messages" setting from Thunderbird. [[https://bugzilla.mozilla.org/show_bug.cgi?id=284933|Enhancement request]].
Line 37: Line 45:
 * [[mutt|Using mutt with IMAP]]
Line 41: Line 50:
== Squirrelmail ==
 * Configuration asks IMAP server name for some workarounds, I'm not aware of Dovecot requiring any so just select the "other" option. By default it uses INBOX-prefix, remove it.
 * [http://www.squirrelmail.org/wiki/ComposeErrorOnSend1 Squirrelmail 1.4.5 has broken APPEND command]. Upgrade to 1.4.6.
== SquirrelMail ==
 * Configuration asks IMAP server name for some workarounds. There has been a Dovecot option since 1.4.6 and 1.5.1. For older !SquirrelMail versions, select the "other" option and remove the default INBOX-prefix.
Line 46: Line 54:
Dovecot doesn't want any folder prefix, but leaving it empty in login screen will just use the default. So, change the default from `/etc/imp3/servers.conf`. Search for `'folders' => 'mail/'` and remove the `mail/` part. For IMP2 edit `defaults.php3`, search for `$default->folders = 'mail/';` and remove the `mail/` part.
Dovecot namespace detection works automatically with any recent version of IMP (4.1+).

Quota support is now integrated into the 'imap' driver (as of horde-groupware V1.2), an example config of /imp/config/servers.php is:

{{{
$servers['imap'] = array(
    'name' => 'IMAP Server',
    'server' => 'localhost',
    'hordeauth' => false,
    'protocol' => 'imap/notls',
    'port' => 143,
    'quota' => array('driver'=>'imap'),
);
}}}

== RoundCube Webmail ==
Works fine.

== @Mail Webmail ==
Uses the namespace returned via Dovecot, full support via IMAP/POP3 using [[http://atmail.com/|@Mail]]. Can also read mailbox quota via the getquotaroot IMAP command.

Client issues and configuration

It seems to be quite difficult to implement a working IMAP client. Best Practices for Implementing an IMAP Client tries to help you with it.

Apple Mail.app

On Mac OS X Leopard 10.5 Mail.app appears to support subscribe/unsubscribe by right clicking on a mailbox, selecting 'Get Account Info' and selecting 'Subscription List' from tabs. This however doesn't really work with any IMAP server.

Apple Mail 3.6 (that comes with OS X 10.5 Leopard) supports subscribing/unsubscribing to folders in the public namespace.

Outlook

  • You should enable outlook-idle workaround with IMAP.

  • You should enable outlook-no-nuls workaround with POP3.

  • Outlook 2003 has problems with older Dovecot's default POP3 UIDL format, which causes it to download the same mails over and over again if "leave mails to server" option is enabled. See pop3_uidl_format setting.

  • Outlook might not hide or purge deleted items by default. Microsoft has a how-to that shows how to fix this (Outlook 2007, not Outlook 2003).

  • If some Outlook users don't see new or sent mails in the appropriate folders after a migration from UW IMAPd even if they are visible in other clients (e.g. Roundcube, Thunderbird, or on the disk itself), and you get the error message "BAD Error in IMAP command UID: Invalid UID messageset" in the log or rawlog: It helps to remove the problematic IMAP account completely from Outlook and recreating it again there. It speaks a different IMAP afterwards, so there are reasons to believe it caches the details of some server on the first connect and doesn't refresh them even if you change the server's hostname in the account settings.

Outlook Express 6

  • Using "Headers only" synchronization is buggy and can cause "Message is no longer available on this server" error when opening a mail. This isn't Dovecot specific problem, and I'm not aware of any possible workarounds at the moment for this in server side.
  • You should enable outlook-idle and delay-newmail workarounds for IMAP.

  • You should enable outlook-no-nuls and oe-ns-eoh workarounds for POP3.

Netscape 4.x

  • You should enable netscape-eoh workaround with IMAP, if you still care about supporting this..

Netscape Mail

I'm not actually sure what version exactly this refers to.

  • You should enable oe-ns-eoh workaround for POP3.

Evolution

  • Some versions don't support creating subfolders with mbox format. Evolution in Ubuntu Gutsy, 2.12.0-0ubuntu5, does support creating subfolders, at least when the parent folder is empty.

Mulberry

Seems to be OK.

Thunderbird

  • If you're using mbox, dbox or Maildir with :LAYOUT=fs ,

    • You should enable tb-extra-mailbox-sep workaround for IMAP. Bug report.

  • If you're using mbox:

    • You'll have to disable "Server supports folders that contain sub-folders and messages" setting from Thunderbird. Enhancement request.

Mutt

  • New mutt versions supporting IDLE command will hang with Dovecot versions earlier than v1.0beta3. Upgrade Dovecot or disable IDLE by setting imap_idle=no in .muttrc.
  • Using mutt with IMAP

Pine

Seems to be OK.

SquirrelMail

  • Configuration asks IMAP server name for some workarounds. There has been a Dovecot option since 1.4.6 and 1.5.1. For older SquirrelMail versions, select the "other" option and remove the default INBOX-prefix.

Horde IMP

Dovecot namespace detection works automatically with any recent version of IMP (4.1+).

Quota support is now integrated into the 'imap' driver (as of horde-groupware V1.2), an example config of /imp/config/servers.php is:

$servers['imap'] = array(
    'name' => 'IMAP Server',
    'server' => 'localhost',
    'hordeauth' => false,
    'protocol' => 'imap/notls',
    'port' => 143,
    'quota' => array('driver'=>'imap'),
);

RoundCube Webmail

Works fine.

@Mail Webmail

Uses the namespace returned via Dovecot, full support via IMAP/POP3 using @Mail. Can also read mailbox quota via the getquotaroot IMAP command.

None: Clients (last edited 2011-03-31 07:38:08 by TimoSirainen)