This documentation is for Dovecot v1.x, see wiki2 for v2.x documentation.
Differences between revisions 236 and 376 (spanning 140 versions)
Revision 236 as of 2005-11-02 18:30:09
Size: 2428
Editor: MarkPlaksin
Comment:
Revision 376 as of 2013-07-31 09:06:11
Size: 5077
Editor: TimoSirainen
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#acl TimoSirainen:read,write,delete,revert,admin All:read
Line 2: Line 3:
 '''Dovecot Wiki Contents''' = Welcome to the Dovecot Wiki =
 * Back to '''[[http://www.dovecot.org/|Dovecot homepage]]'''
 * QuickConfiguration for people in hurry
 * [[WhyDoesItNotWork|Why doesn't Dovecot work?]]
Line 4: Line 8:
 * [http://dovecot.org/ Dovecot Homepage] = Dovecot Wiki Contents =
<<TableOfContents>>
Line 6: Line 11:
[[TableOfContents]] = Generic information about mail servers =
 * [[MailServerOverview|Overview of how everything works together]]
 * Mail protocols: [[http://en.wikipedia.org/wiki/Imap|IMAP]], [[http://en.wikipedia.org/wiki/Pop3|POP3]] and [[http://en.wikipedia.org/wiki/Smtp|SMTP]]
 * [[MDA|Mail delivery agents and Sieve]]
 * [[MailboxFormat|Mailbox formats]]
  * [[IndexFiles|Dovecot's index files]]
 * [[Authentication|User authentication]]
  * [[Sasl|SASL]]
Line 8: Line 20:
= Overview = = 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.
Line 10: Line 23:
 * [wiki:DovecotFeatures Dovecot Features]
 * [wiki:Testimonials Testimonials]
If you're in a hurry and you already know enough about mail servers, QuickConfiguration may be more helpful to you instead.
Line 13: Line 25:
= Installing =  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]]
 1. [[TestInstallation|Testing that everything works]]
  * [[TestPop3Installation|Testing POP3 installation]]
 1. [[FinishBasicConfiguration|Finishing the test installation]]
Line 15: Line 36:
 * '''Installing binaries'''
  * [wiki:CompilingSource Compiling Dovecot from sources]
  * [wiki:PrebuiltBinaries Installing prebuilt binaries]
= 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 deliver, Local Delivery Agent (LDA)]]
 * [[LDA/Sieve|Sieve]] and ManageSieve
 * [[PostLoginScripting|Post-login scripting]]
Line 19: Line 67:
 * '''Configuration Files'''
  * [wiki:MainConfig Main Config File]
= HOWTOs, examples and tutorials =
 * [[HowTo|HOWTOs, examples and tutorials]] for different installations
 * [[DovecotServerInstallations|Existing Dovecot installations]]
Line 22: Line 71:
 * [wiki:BasicInstall Basic Installation]
 * [wiki:Authentication Understanding user authentication]
  * [wiki:UserIds System user IDs used by Dovecot]
  * [wiki:VirtualUsers Virtual user configuration]
  * [wiki:MultipleAuth Multiple authentication databases]
  * [wiki:MasterPassword Master password]
  * [wiki:Sasl SASL explained]
  * [wiki:AuthSpecials Special authentication features]
   * IMAP login referrals
   * IMAP and POP3 proxying
 * [wiki:MailLocation Mail location]
  * [wiki:Namespaces Namespaces]
  * [wiki:SharedFolders Shared Folders]
 * [wiki:Quota Quota]
 * [wiki:Rootless Rootless installation]
 * [wiki:PopBSMTPAndDovecot POP-before-SMTP]

= Scenarios =

 * [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]
 * [wiki:PopRelay Pop Relay Compatibility]
 * [wiki:ImapProxy IMAP and POP3 session proxying]
 * [wiki:LDA Dovecot LDA]
 * [wiki:ChainedSSLCertificates Chained SSL certificates]

= Migration =

 * [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]
= Migration from existing systems =
 * [[Migration|From other IMAP/POP3 servers]]
  * [[MissingMailboxes|My mailboxes are lost after migrating to Dovecot!]]
 * [[UpgradingDovecot|Upgrading Dovecot to a new version]]
 * [[Migration/MailFormat|Converting between mailbox formats]] (mbox <-> Maildir, etc.)
Line 60: Line 78:
 * [[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
 * [[Debugging/Rawlog|Rawlog]] can be used to log post-login IMAP/POP3 traffic
 * [[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
 * [[DomainLost|%d expands to empty string]]
 * [[PreAuth|pre-authentificated sessions]]
 * [[http://dovecot.org/bugreport.html|Sending bug reports]], debugging crashes and sniffing network traffic
Line 61: Line 92:
 * QuestionsAndAnswers
 * [wiki:InternalErrors Internal error messages]
 * [wiki:VarMailDotLock /var/mail/user.lock issues]
 * MboxProblems

= Odds and Ends =

 * [wiki:Iptables Listening on Additional Ports] using IP Tables
= Tuning =
 * [[PerformanceTuning|Performance tuning]]
 * [[SecurityTuning|Security tuning]]
  * [[Chrooting]]
Line 71: Line 98:
 * [[MainConfig|Full configuration file reference]] (automatically updated from dovecot-example.conf)
 * [[CommandLine|Command line arguments]]
 * [[Design|Dovecot's design]]
  * [[Authentication Protocol]]
 * [[Clients|Client issues and configuration]]
Line 72: Line 104:
 * MailboxFormats
 * ["mutt"]

= Features / Status =
 * CoreFeatures
## * KnownBugs
= Misc =
 * [[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)

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
  2. Checking where mail is delivered to

  3. Configuring Dovecot

  4. Running Dovecot

  5. Logging

  6. Testing that everything works

  7. Finishing the test installation

Dovecot configuration

HOWTOs, examples and tutorials

Migration from existing systems

Troubleshooting

Tuning

Reference

Misc

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