This documentation is for Dovecot v1.x, see wiki2 for v2.x documentation.

Installing Prebuilt Binaries

In binary packages the configuration file is typically in /etc/dovecot.conf.

Debian

apt-get install dovecot-imapd dovecot-pop3d

For stable you can get newer versions from backports.org (currently 1.2.9-1~bpo50+1 in lenny-backports instead of 1.0.15-2.3+lenny1 in lenny). Follow the instructions from http://backports-master.debian.org/Instructions/ and then run the above apt-get install command.

Automatically Built Packages

For those of you who like to live on the edge, there are Debian repositories available with hourly updates from recent Dovecot v1.2/v2.0 changes in the Mercurial repositories. The builder scripts automatically release a new set of Debian packages when they notice any changes in any of the v1.2 or v2.0 repositories. The packages have Pigeonhole Sieve and ManageSieve included. Currently, only binaries for the i386 and amd64 architectures are provided for the Debian stable and testing releases. Source packages are available to build the packages for other architectures and (possibly) for Debian releases other than testing and stable. These packages are directly based on the latest official Debian packages for Dovecot, but some of the small Debian-specific patches that are part of the official packages are currently not included. Usage should be similar to the backports.org repository (see explanation above), but the lines added to /etc/apt/sources.list are different and the keyring package has a different name (see below).

Needless to say: do NOT use these repositories for systems that need to be STABLE.

For Dovecot v1.2 and Debian testing (Wheezy) the following line needs to be added to your /etc/apt/sources.list:

deb http://xi.rename-it.nl/debian/ testing-auto/dovecot-1.2 main

And if you would like to get the source packages, you should add:

deb-src http://xi.rename-it.nl/debian/ testing-auto/dovecot-1.2 main

Substitute testing with stable in the lines above if you are running Debian stable (Squeeze) and substitute 1.2 with 2.0 if you want to use the Dovecot v2.0 packages. Support for Debian oldstable (Lenny) is only provided for Dovecot v2.0, for which you must substitute testing with oldstable.

If you want apt to verify the downloaded packages, you can import the automatic archive’s key into apt:

apt-get install debian-dovecot-auto-keyring

or:

wget -O - http://xi.rename-it.nl/debian/archive.key | apt-key add -

For questions, comments and requests, you can send an e-mail to Stephan Bosch (stephan at rename-it dot nl).

Ubuntu

apt-get install dovecot-imapd dovecot-pop3d

Ubuntu version and name

Package name

Dovecot version

OS release date

Supported until

4.10 Warty Warthog

0.99.10.6-3ubuntu1

0.99.10.6

2004-10-20

2006-04-30

5.04 Hoary Hedgehog

0.99.13-3

0.99.13

2005-04-08

2006-10-31

5.10 Breezy Badger

0.99.14-1ubuntu1

0.99.14

2005-10-13

2007-04-13

6.06 LTS Dapper Drake

1.0.beta3-3ubuntu5.6

1.0 beta 3

2006-06-01

2011-06

6.10 Edgy Eft

1.0.rc2-1ubuntu2.3

1.0 rc2

2006-10-26

2008-04-25

7.04 Feisty Fawn

1.0.rc17-1ubuntu2.3

1.0 rc17

2007-04-19

2008-10-19

7.10 Gutsy Gibbon

1.0.5-1ubuntu2.2

1.0.5

2007-10-18

2009-04-18

8.04 LTS Hardy Heron

1.0.10-1ubuntu5.1

1.0.10

2008-04-24

2013-04

8.10 Intrepix Ibex

1.1.4-0ubuntu1.2

1.1.4

2008-10-30

2010-04

9.04 Jaunty Jackalope

1.1.11-0ubuntu4

1.1.11

2009-04-23

2010-08

9.10 Karmic Koala

1.1.11-0ubuntu11

1.1.11

2009-10-27

2011-04

10.04 LTS Lucid Lynx

1.2.9-1ubuntu6

1.2.9

2010-04-29

2015-04

These packages including the Dovecot Sieve Plugin and all other nice features.

For the latest Dovecot for latest Ubuntu LTS see Xiaoka APT Repository.

Fedora and RHEL (and CentOS/Scientific Linux/...)

Fedora includes dovecot since its first release.

Fedora version and name

Dovecot Base ver.

Dovecot Updated ver.

OS release date

Supported until

Fedora Core 1 Yarrow

0.99.10

0.99.10.5

2003–11–05

2004-09-20

Fedora Core 2 Tettnang

0.99.10.4

0.99.13

2004–05–18

2005-04-11

Fedora Core 3 Heidelberg

0.99.11

0.99.13

2004–11–08

2006-01-16

Fedora Core 4 Stentz

0.99.14

0.99.14

2005–06–13

2006-08-07

Fedora Core 5 Bordeaux

1.0.0 beta2

1.0.0 beta8

2006–03–20

2007-07-02

Fedora Core 6 Zod

1.0.0 rc7

1.0.3

2006–10–24

2007-12-07

Fedora Core 7 Moonshine

1.0.0

1.0.13

2007–05–31

2008-06-13

Fedora 8 Werewolf

1.0.5

1.0.15

2007–11–08

2009-01-07

Fedora 9 Sulphur

1.0.13

1.0.15

2008–05–13

2009-07-10

Fedora 10 Cambridge

1.1.6

1.1.20

2008–11–25

2009-12-18

Fedora 11 Leonidas

1.2.0

1.2.11

2009–06–09

2010-07

Fedora 12 Constantine

1.2.6

1.2.11

2009–11–17

TBA

Fedora 13 Goddard

1.2.11

1.2.11

2010–05–25

TBA

Rawhide (Fedora 14)

2.x

2.x

2010–10–26 ?

TBA

Red Hat Enterprise Linux includes Dovecot since RHEL4.

Fedora version and name

Dovecot Base ver.

Dovecot Updated ver.

OS release date

Supported until

RHEL4

0.99.11

0.99.11

2005-02-15

2012-02-29

RHEL5

1.0.0

1.0.7

2007-03-14

2014-03-31

Doing a fresh install of Fedora Core 2 and later, Dovecot will be installed as the default IMAP server. If you're upgrading from Fedora Core 1, see /FedoraUpgrade.

If you don't have Dovecot already installed, use:

yum install dovecot

(replace yum with smart/apt/up2date if that's your depsolver)

To start the dovecot daemon and ensure it starts with each system boot run

service dovecot start
chkconfig dovecot on

RPMs of newer Dovecot and Sieve packages

You can get the latest stable dovecot package and the package for the sieve plugin from ATrpms.net under http://ATrpms.net/name/dovecot/ and http://ATrpms.net/name/dovecot-sieve/. The RHEL packages will also work with CentOS/Scientific Linux and any other RHEL clone.

Building your own rpms

There are situations where the supplied packages don't suit your needs, for example when there is a patch you want to add, or perhaps the packages have not yet updated to the latest versions as fast as you need them.

Note that the following only discusses plain rebuilds of a src.rpm. The true work is in modifying the src.rpm which is out of the scope of this wiki. Use standard rpm procedures to extract the contents of the src.rpm, edit the specfile, add patches, update sources etc. The following will assume you have crafted a src.rpm similar to the one at ATrpms'.

If you want to rebuild the rpms using ATrpms' src.rpm or a derivative, use this command:

# rpmbuild --rebuild dovecot-*.src.rpm

This works on Fedora Core w/o any further modifications.

If you are on a platform with an rpm version older that 4.4 (for example RHEL4 and RHEL3) then create the following file (or add the contents to /etc/rpm/macros or ~/.rpmmacros)

# /etc/rpm/macros.bcond
# macros used in rpm 4.4, not available in previous versions
%bcond_with()           %{expand:%%{?_with_%{1}:%%global with_%{1} 1}}
%bcond_without()        %{expand:%%{!?_without_%{1}:%%global without_%{1} 1}}
%with()         %{expand:%%{?with_%{1}:1}%%{!?with_%{1}:0}}
%without()      %{expand:%%{?without_%{1}:0}%%{!?without_%{1}:1}}

There are also special switches for older platforms:

--without inotify   Don't try to use inotify
--with forcequota2  For the use of quota version 2 (if otherwise wrongly detected)

For example on RHEL4 you need

# rpmbuild --rebuild --without inotify --with forcequota2 dovecot-*.src.rpm

For RHEL3 you only need (on RHEL3 quota headers are not broken)

# rpmbuild --rebuild --without inotify dovecot-*.src.rpm

SUSE

Dovecot ships with SUSE for quite some time. Upto 10.0 SUSE shipped with 0.99.xx. SUSE 10.1 will have 1.0-beta3, including LDA support.

yast -i dovecot
chkconfig dovecot on
rcdovecot start

By default ssl disabled. so you need to create an SSL certificitate and than enable it in the dovecot config. For your private server you can do:

cd /usr/share/doc/packages/dovecot/
sh mkcert.sh
sed -i -e 's|ssl_disable = .*|ssl_disable = no|' /etc/dovecot/dovecot.conf
rcdovecot restart

FreeBSD

cd /usr/ports/mail/dovecot; make install

OpenBSD

Use the OpenBSD Package system. For background information see thePackages and Ports FAQ.

Here's an example from a fresh OpenBSD 3.9 install where I've given my account sudo privileges and I'm using the default OpenBSD shell (ksh).

Set up your PKG_SRC environment variable by adding a line like the following to your .profile and then logging out and back in again to get the .profile re-read. (There's probably a more graceful way of doing this but this!)

$ export PKG_PATH=ftp://your.ftp.mirror/pub/OpenBSD/3.9/packages/`machine -a`/

Install the package using pkg_add, with the -i option to allow you to choose which version of the package you want. Here's a case where I chose the later of the two postgresql ports that were available on my repository, and this caused the packages system to prompt me for a choice on the postgresql client dependency.

$ sudo pkg_add -i dovecot
Password:
Ambiguous: dovecot could be dovecot-1.0.beta3 dovecot-1.0.beta3-ldap dovecot-1.0.beta3-ldap-mysql-postgresql dovecot-1.0.beta3-mysql dovecot-1.0.beta3-postgresql dovecot-1.0.beta8 dovecot-1.0.beta8-ldap dovecot-1.0.beta8-ldap-mysql-postgresql dovecot-1.0.beta8-mysql dovecot-1.0.beta8-postgresql
Choose one package
         0: <None>
         1: dovecot-1.0.beta3
         2: dovecot-1.0.beta3-ldap
         3: dovecot-1.0.beta3-ldap-mysql-postgresql
         4: dovecot-1.0.beta3-mysql
         5: dovecot-1.0.beta3-postgresql
         6: dovecot-1.0.beta8
         7: dovecot-1.0.beta8-ldap
         8: dovecot-1.0.beta8-ldap-mysql-postgresql
         9: dovecot-1.0.beta8-mysql
        10: dovecot-1.0.beta8-postgresql
Your choice: 10
Choose dependency for dovecot-1.0.beta8-postgresql:
         0: postgresql-client-8.1.4
         1: postgresql-client-8.1.3
Your choice: 0
dovecot-1.0.beta8-postgresql:libiconv-1.9.2p3: complete
dovecot-1.0.beta8-postgresql:postgresql-client-8.1.4: complete
dovecot-1.0.beta8-postgresql: complete
--- dovecot-1.0.beta8-postgresql -------------------
Files to facilitate the generation of a self-signed
certificate and key for Dovecot have been installed:
/etc/ssl/dovecot-openssl.cnf (Edit this accordingly!)
/usr/local/sbin/dovecot-mkcert.sh
If this has been or will be accomplished by other means,
use the following paths for the files:
/etc/ssl/dovecotcert.pem
/etc/ssl/private/dovecot.pem
If you wish to have Dovecot started automatically at boot time,
simply add the follow lines to /etc/rc.local:
if [ -x /usr/local/sbin/dovecot ]; then
        echo -n ' dovecot';       /usr/local/sbin/dovecot
fi
$

Follow the advice about adding the lines to /etc/rc.local.

In the above case, you would also need a postgresql server somewhere - you could install it on the same machine using "pkg_add -i postgresql-server".

NetBSD and DragonFly

cd /usr/pkgsrc/mail/dovecot; make install

Mac OS X MacPorts

sudo port install dovecot

Mandriva 2007.0 and 2007.1

Install with rpm or urpmi.

urpmi dovecot

The Mandriva default locations where executables, doc etc. are installed, are sometimes different from other platforms. The default rpm (created from the source rpm as described in the 'Compiling Dovecot from sources' chapter) uses the following locations:

/usr/lib/dovecot/ to store executable files (imap-login, imap, etc.)
/usr/sbin/ for dovecot and dovecotpw
/usr/share/dovecot/ for .la and .lo files
/usr/share/dovecot/imap/,
/usr/share/dovecot/lda/,
/usr/share/dovecot/pop3/ hold symlinks to the files one level up
/usr/share/doc/dovecot-1.0.rc14/ to store template .conf, .cnf, .pl, README, etc. files
/etc to store the live dovecot.conf
/etc/ssl/dovecot/[certs,private]/ to store the OpenSSL certificate and key

Arch Linux

pacman -Sy extra/dovecot

Also see http://www.archlinux.org/packages/search/?q=dovecot

Solaris

For Solaris 8 - 10: Install pkg-get from http://www.opencsw.org/pkg-get, adjust /opt/csw/etc/pkg-get.conf with a mirror nearby, and run

pkg-get -U
pkg-get -i dovecot

The CMU Sieve plugin is also available

pkg-get -i dovecot_sieve

PrebuiltBinaries (last edited 2012-02-16 10:52:45 by 128)