This documentation is for Dovecot v2.x, see wiki1 for v1.x documentation.
Differences between revisions 256 and 257
Revision 256 as of 2006-11-05 16:20:00
Size: 3115
Editor: TimoSirainen
Comment:
Revision 257 as of 2006-11-05 19:00:36
Size: 4655
Editor: TimoSirainen
Comment: I think this is good enough for a new front page now
Deletions are marked like this. Additions are marked like this.
Line 10: Line 10:
----
= Overview =
Line 13: Line 11:
 * [wiki:DovecotFeatures Dovecot Features]
 * [wiki:Testimonials Testimonials]
= Generic information about mail servers =
Line 16: Line 13:
= Installing =   * [: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]
Line 18: Line 20:
 * '''Installing binaries'''
  * [wiki:CompilingSource Compiling Dovecot from sources]
  * [wiki:PrebuiltBinaries Installing prebuilt binaries]
= A simple Dovecot installation =
Line 22: Line 22:
 * '''Configuration Files'''
  * [wiki:MainConfig Main Config File]
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.
Line 25: Line 24:
 * [wiki:QuickConfiguration Quick configuration]
 * [wiki:BasicInstall Basic Installation]
 * [wiki:Authentication Understanding user authentication]
  * [wiki:UserIds System user IDs used by Dovecot]
  * [wiki:VirtualUsers Virtual user configuration]
  * [wiki:Authentication/RestrictAccess Restricting users' access]
  * [wiki:MultipleAuth Multiple authentication databases]
  * [wiki:MasterPassword Master password]
  * [wiki:Sasl SASL explained]
  * [wiki:CRAM-MD5 CRAM-MD5 authentication HOWTO]
  * [wiki:PasswordDatabase/ExtraFields Special authentication features]
   * IMAP login referrals
   * IMAP and POP3 proxying
 * [wiki:MailLocation Mail location]
  * [wiki:Namespaces Namespaces]
  * [wiki:SharedFolders Shared Folders]
 * [wiki:Plugins Plugins]
  * [wiki:Quota Quota]
  * [wiki:ACL ACLs]
 * [wiki:NFS NFS]
 * [wiki:Rootless Rootless installation]
 * [wiki:PopBSMTPAndDovecot POP-before-SMTP]
If you're in a hurry and you already know enough about mail servers, QuickConfiguration may be helpful for you instead.
Line 48: Line 26:
= Scenarios =   1. Installing
      * [:CompilingSource:Compiling from sources]
      * [:PrebuiltBinaries:Installing prebuilt binaries]
  1. [:FindMailLocation:Checking where mail is delivered to]
  1. [:BasicConfiguration:Configuring Dovecot]
  1. [:RunningDovecot:Running Dovecot]
  1. [:Logging:Logging]
  1. [:TestInstallation:Testing that everything works]
  1. [:FinishBasicConfiguration:Finishing the test installation]
Line 50: Line 36:
 * [wiki:VirtualUsers Overview of virtual user setup]
 * [wiki:DovecotOpenLdap Virtual user support with OpenLDAP]
   * [wiki:DoveLdapCheatSheet Cheat sheet]
 * [http://wanderingbarque.com/mailserver.html Virtual user support with Postfix, OpenLDAP and Jamm]
 * [wiki:DovecotPostgresql Virtual user support with PostgreSQL and Postfix]
 * [wiki:VirtualhostingWithExim Virtual user support with Exim]
 * [wiki:DebianStable Default Debian stable setup with Exim, modified to use Maildir]
 * [http://postfix.pentachron.net/ Virtual user support with MySQL, Postfix and CCC]
 * [wiki:PopRelay Pop Relay Compatibility]
 * [wiki:ImapProxy IMAP and POP3 session proxying]
 * [wiki:LDA Dovecot LDA]
 * [wiki:ChainedSSLCertificates Chained SSL certificates]
= Full guide to setting up a new Dovecot installation =
Line 63: Line 38:
= Migration = This guide assumes that you have already managed to run Dovecot successfully, as described in the "A simple Dovecot installation" guide above.
Line 65: Line 40:
 * [wiki:Migration Migration to Dovecot from existing POP / IMAP server]
 * [wiki:MissingMailboxes My mailboxes are lost after migrating to Dovecot!]
 * [wiki:UpgradingDovecot Upgrading from Dovecot 0.99.x to 1.0]
 * Starting guidelines
   * [:SystemUsers:System users]
   * [:VirtualUsers:Virtual users]
 * [:Authentication:Authentication configuration]
   * [:PasswordDatabase:Password databases]
   * [:UserDatabase:User databases]
   * [:MultipleAuth:Multiple authentication databases]
   * [:Kerberos:Kerberos]
   * [:Authentication/RestrictAccess:Restricting users' access]
   * [:PasswordDatabase/ExtraFields:Special authentication features]
   * [:MasterPassword:Master users]
 * [:MailLocation:Mailbox location configuration]
   * [:MailLocation/LocalDisk:Mails stored in local disk]
   * [:MailLocation/SharedDisk:Mails stored in shared filesystem] ([:NFS:NFS], clustered FS)
   * [:MailLocation/Maildir:Maildir configuration]
   * [:MailLocation/Mbox:Mbox configuration]
   * [:Namespaces:Namespaces]
   * [:SharedFolders:Shared folders]
 * [:SSL:SSL]
   * [:ChainedSSLCertificates:Chained SSL certificates]
 * [:Plugins:Plugins]
  * [:Quota:Quota]
  * [:ACL:ACLs]
 * [:POP3:POP3]
 * [:LDA:Dovecot's local delivery agent]

= Examples / Scenarios =

 * [:DovecotServerInstallations:Existing Dovecot installations]

[:VirtualUsers:Virtual users]:

 * [:DovecotOpenLdap:OpenLDAP]
   * [:DoveLdapCheatSheet:Cheat sheet]
 * [http://wanderingbarque.com/mailserver.html Postfix, OpenLDAP and Jamm]
 * [:DovecotPostgresql:PostgreSQL and Postfix]
 * [:VirtualhostingWithExim:Exim]
 * [http://postfix.pentachron.net/ MySQL, Postfix and CCC]

Others:

 * [: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]
 * [:Migration/POP3:POP3 -> IMAP]
Line 71: Line 98:
 * QuestionsAndAnswers
 * [wiki:InternalErrors Internal error messages]
 * [wiki:VarMailDotLock /var/mail/user.lock issues]
 * MboxProblems
 * MysqlProblems
 * RecentProblems
 * DebuggingAuthentication
 * [wiki:Debugging/ProcessTracing Process tracing]
 * [:Debugging:Finding the exact error message]
  * [:InternalErrors:Internal error messages]
 * [:CommonProblems:Common problems]
  * [:DebuggingAuthentication:Debugging authentication]
  * [:VarMailDotLock:/var/mail/user.lock issues]
 * [:Debugging/ProcessTracing:Process tracing] is useful when Dovecot seems slow or hangs completely
 * [:Clients:Client issues and configuration]
 * [:Support:Getting support]
Line 80: Line 107:
= Odds and Ends = = Tuning =
Line 82: Line 109:
 * [wiki:Iptables Listening on Additional Ports] using IP Tables
 * DovecotServerInstallations
 * OrphanedPages (that are not linked to by other pages)
 * [:PerformanceTuning:Performance tuning]
 * [:SecurityTuning:Security tuning]
Line 88: Line 114:
 * [wiki:MailboxFormat Mailbox formats]
 * [wiki:Design Dovecot design]
 * ["mutt"]
 * CommandLine Arguments
 * [:MainConfig:Full configuration file reference] (automatically updated from dovecot.conf)
 * [:CommandLine:Command line arguments]
 * [:Design:Dovecot's design]
 * [:Clients:Client issues and configuration]
Line 93: Line 119:
= Features / Status =
 * CoreFeatures
## * KnownBugs
= Misc =

 * [:CoreFeatures:Current features and roadmap] / [:DovecotFeatures:another features page] (These need to be merged somehow)
 * [:Testimonials:Testimonials]
 * [:Iptables:Listening on Additional Ports] using IP Tables
 * OrphanedPages (that are not linked to by other pages)

Welcome to the Dovecot Wiki

For the [http://dovecot.org/ Dovecot Homepage, click here]

Dovecot Wiki Contents

TableOfContents

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 helpful for 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: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]

  • [:Authentication:Authentication configuration]

    • [:PasswordDatabase:Password databases]

    • [:UserDatabase:User databases]

    • [:MultipleAuth:Multiple authentication databases]

    • [:Kerberos:Kerberos]

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

    • [:PasswordDatabase/ExtraFields:Special authentication features]

    • [:MasterPassword:Master users]

  • [:MailLocation:Mailbox location configuration]

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

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

    • [:MailLocation/Maildir:Maildir configuration]

    • [:MailLocation/Mbox:Mbox configuration]

    • [:Namespaces:Namespaces]

    • [:SharedFolders:Shared folders]

  • [:SSL:SSL]

    • [:ChainedSSLCertificates:Chained SSL certificates]

  • [:Plugins:Plugins]

    • [:Quota:Quota]

    • [:ACL:ACLs]

  • [:POP3:POP3]
  • [:LDA:Dovecot's local delivery agent]

Examples / Scenarios

  • [:DovecotServerInstallations:Existing Dovecot installations]

[:VirtualUsers:Virtual users]:

Others:

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

  • [:Migration/POP3:POP3 -> IMAP]

Troubleshooting

  • [:Debugging:Finding the exact error message]

    • [:InternalErrors:Internal error messages]

  • [:CommonProblems:Common problems]

    • [:DebuggingAuthentication:Debugging authentication]

    • [:VarMailDotLock:/var/mail/user.lock issues]

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

  • [:Clients:Client issues and configuration]

  • [:Support:Getting support]

Tuning

  • [:PerformanceTuning:Performance tuning]

  • [:SecurityTuning:Security tuning]

Reference

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

  • [:CommandLine:Command line arguments]

  • [:Design:Dovecot's design]

  • [:Clients:Client issues and configuration]

Misc

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

  • [:Testimonials:Testimonials]

  • [:Iptables:Listening on Additional Ports] using IP Tables

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

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