This documentation is for Dovecot v1.x, see wiki2 for v2.x documentation.
Differences between revisions 280 and 281
Revision 280 as of 2007-03-19 02:24:11
Size: 5264
Editor: TimoSirainen
Revision 281 as of 2007-03-19 03:19:22
Size: 5270
Editor: TimoSirainen
Deletions are marked like this. Additions are marked like this.
Line 59: Line 59:
 * ["POP3"]  * ["POP3Server"]

Welcome to the Dovecot Wiki

Dovecot Wiki Contents


Generic information about mail servers

  • [:MailServerOverview:Overview of how everything works together]

  • [:MailProtocols:Mail protocols] (["IMAP"], ["POP3"] and ["SMTP"])

  • [:MDA:Mail delivery agents and Sieve]

  • [:MailboxFormat:Mailbox formats]

  • [:Authentication:User authentication]

    • [:Sasl:SASL]

A simple 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]

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.

  • Starting guidelines
    • [:SystemUsers:System users]

    • [:VirtualUsers:Virtual users]

    • [:UserIds:UNIX User IDs 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]

  • [: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"]
  • [:LDA:Dovecot's local delivery agent]

  • [:PostLoginScripting:Post-login scripting]

Examples / Scenarios

  • [:DovecotServerInstallations:Existing Dovecot installations]

[:VirtualUsers:Virtual users]:


  • [: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]

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:Mbox <-> Maildir]


  • WhyDoesItNotWork

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

  • [:DebuggingAuthentication: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]

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

  • [ 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

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

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

None: FrontPage (last edited 2013-07-31 09:06:11 by TimoSirainen)