This documentation is for Dovecot v2.x, see wiki1 for v1.x documentation.
Differences between revisions 301 and 304 (spanning 3 versions)
Revision 301 as of 2007-06-11 23:50:56
Size: 5717
Editor: lns-bzn-33-82-252-12-240
Revision 304 as of 2007-08-06 15:26:05
Size: 4704
Editor: danielwatts
Comment: adding caching section
Deletions are marked like this. Additions are marked like this.
Line 18: Line 18:
= A simple Dovecot installation = = Dovecot installation =
Line 33: Line 33:
= Full guide to setting up a new Dovecot installation =
This guide assumes that you have already managed to run Dovecot successfully, as described in the "A simple Dovecot installation" guide above.
= Dovecot configuration =
Line 39: Line 38:
  * [:UserIds:UNIX User IDs used by Dovecot]   * [:UserIds:System users used by Dovecot]
Line 48: Line 47:
  * [:Authentication/Caching:Caching]
Line 63: Line 63:
= Examples / Scenarios = = HOWTOs, examples and tutorials =
 * [:HowTo:HOWTOs, examples and tutorials] for different installations
Line 65: Line 66:
[:VirtualUsers:Virtual users]:

 * [:DovecotOpenLdap:OpenLDAP]
  * [:DoveLdapCheatSheet:Cheat sheet]
 * [ Postfix, OpenLDAP and Jamm] (for Dovecot v0.99.x, settings incompatible with v1.0)
 * [:DovecotPostgresql:PostgreSQL and Postfix]
 * VirtualhostingWithExim
 * [ MySQL, Postfix and CCC]
 * [:DovecotLDAPostfixAdminMySQL:Dovecot, Postfix with Dovecot LDA transport and Dovecot SASL Auth, Postfix Admin, MySQL and SquirrelMail]
 * [ MySQL, Exim, SpamAssassin and ClamAV]

 * [:DebianStable:Default Debian stable setup with Exim, modified to use Maildir]
 * [:ImapProxy:IMAP and POP3 session proxying]
 * [:CRAM-MD5:CRAM-MD5 authentication HOWTO]
 * [:Rootless:Rootless installation]
 * [:PopBSMTPAndDovecot:POP-before-SMTP]
  * [:PopRelay:Pop Relay Compatibility]

Welcome to the Dovecot Wiki

Dovecot Wiki Contents


Generic information about mail servers

Dovecot installation

It's a good idea to start with a simple Dovecot installation to see that everything works. After that you can start changing things one at a time, so if you run into trouble you know immediately where the problem is.

If you're in a hurry and you already know enough about mail servers, QuickConfiguration may be more helpful to you instead.

  1. Installing
    • [:CompilingSource:Compiling from sources]

    • [:PrebuiltBinaries:Installing prebuilt binaries]

  2. [:FindMailLocation:Checking where mail is delivered to]

  3. [:BasicConfiguration:Configuring Dovecot]

  4. [:RunningDovecot:Running Dovecot]

  5. ["Logging"]
  6. [:TestInstallation:Testing that everything works]

  7. [:FinishBasicConfiguration:Finishing the test installation]

Dovecot configuration

  • Starting guidelines
    • [:SystemUsers:System users]

    • [:VirtualUsers:Virtual users]

    • [:UserIds:System users used by Dovecot]

  • [:Authentication:Authentication configuration]

    • [:PasswordDatabase:Password databases]

    • [:UserDatabase:User databases]

    • [:Authentication/MultipleDatabases:Multiple authentication databases]

    • [:Authentication/Kerberos:Kerberos]

    • [:Authentication/RestrictAccess:Restricting users' access]

    • [:PasswordDatabase/ExtraFields:Special authentication features]

    • [:Authentication/MasterUsers:Master users]

    • [:Authentication/Caching:Caching]

  • [:MailLocation:Mailbox location configuration]

    • [:MailLocation/LocalDisk:Mails stored in local disk]

    • [:MailLocation/SharedDisk:Mails stored in shared filesystem] (["NFS"], clustered FS)

    • [:MailLocation/Maildir:Maildir configuration]

    • [:MailLocation/Mbox:Mbox configuration]

    • ["Namespaces"]
    • [:SharedMailboxes:Shared mailboxes]

  • [:LoginProcess:Login processes and their settings]

  • ["SSL"] settings and certificate creation
  • ["Plugins"]
    • ["Quota"]
    • [:ACL:Access Control Lists] (ACLs)

  • [:POP3Server:Dovecot as a POP3 server]
  • [:LDA:Dovecot's local delivery agent]

  • [:PostLoginScripting:Post-login scripting]

HOWTOs, examples and tutorials

  • [:HowTo:HOWTOs, examples and tutorials] for different installations

  • [:DovecotServerInstallations:Existing Dovecot installations]

Migration from existing systems

  • [:Migration:From other IMAP/POP3 servers]

    • [:MissingMailboxes:My mailboxes are lost after migrating to Dovecot!]

  • [:UpgradingDovecot:Upgrading from Dovecot 0.99.x to 1.0]

  • [:Migration/MailFormat:Converting between mailbox formats] (mbox <-> Maildir, etc.)


  • [:WhyDoesItNotWork:Why doesn't Dovecot work?]

  • [:Logging:Finding the error message from logs]

  • [:Debugging/Authentication:Debugging authentication]

  • [:Debugging/ProcessTracing:Process tracing] is useful when Dovecot seems slow or hangs completely

  • [:MboxProblems:mbox errors and crashes]

  • [:Clients:Client issues and configuration]

    • [:Clients/NegativeUIDs:Negative UIDs / message sets]

    • [:Debugging/Thunderbird:Debugging using Thunderbird's logging]

  • [:TimeMovedBackwards:"Time moved backwards" error]

  • [ Sending bug reports], debugging crashes and sniffing network traffic


  • [:PerformanceTuning:Performance tuning]

  • [:SecurityTuning:Security tuning]

    • ["Chrooting"]


  • [:MainConfig:Full configuration file reference] (automatically updated from dovecot.conf)

  • [:CommandLine:Command line arguments]

  • [:Design:Dovecot's design]

    • ["Authentication Protocol"]
  • [:Clients:Client issues and configuration]


  • [:CoreFeatures:Current features and roadmap] / [:DovecotFeatures:another features page] (These need to be merged somehow)

  • ["Testimonials"]
  • [:Iptables:Listening on Additional Ports] using: IP Tables or socat

  • OrphanedPages (that are not linked to by other pages)

  • QuestionsAndAnswers (the contents of this page should mostly be moved elsewhere)

None: FrontPage (last edited 2018-08-05 15:21:25 by AkiTuomi)