view INSTALL @ 4157:ed7d77a89b17 HEAD

Updated GNUTLS information.
author Timo Sirainen <>
date Mon, 10 Apr 2006 01:10:20 +0300
parents a5c559c847cc
children 5fe316cdd8a6
line wrap: on
line source

Build Instructions

For most people, the usual:

  sudo make install

is enough. This installs Dovecot under /usr/local.

If you have installed some libraries into locations which require special
include or library paths, you can give them in CPPFLAGS and LDFLAGS
environment variables. For example:

  CPPFLAGS=-I/opt/openssl/include LDFLAGS=-L/opt/openssl/lib ./configure


Rename configuration file:

  mv /usr/local/etc/dovecot-example.conf /usr/local/etc/dovecot.conf

Read through, and make needed modifications. doc/configuration.txt tells
you more about configuring Dovecot.

Once everything is configured, there's two ways to start Dovecot:

 1) Run "dovecot" binary which does everything.

 2) Start it via inetd or similiar by executing "imap-login" or "pop3-login"
    binaries. If you're listening in SSL port, add --ssl parameter.


Dovecot used to support both GNUTLS and OpenSSL libraries, but nowadays
only the OpenSSL code is working.

Optional Configure Options

You can get a full list with:

  ./configure --help

The options are listed like --with-thing or --enable-thing, usually they're
also enabled by default. You can disable them with --without-thing or

Besides the standard options, Dovecot has added these:

  --enable-ipv6           Enable IPv6 support (default)

Enable IPv6 support. By default it's enabled if system is detected to
support it.


Specifies if we use 32bit or 64bit file offsets. 64bit is default if system
supports it (Linux and Solaris does). You most likely won't have mails
larger than 2GB, so you may want to drop this to 32bit for a bit smaller
disk and memory usage.


Specifies memory alignment, needed with many non-x86 systems and should
speed up x86 systems too. Default is 8 with everyone to make sure 64bit
memory accessing work. Currently it should also be safe to set to 4 when
using 32bit file offets. With x86 it could be 1 as well if you want to save
a bit of disk space (in file) and memory.

  --enable-debug          Enable some extra checks for debugging

This is mostly useful for developers. It does quite a lot of unnecessary
work but should catch some programming mistakes more quickly.

  --with-ssl=gnutls|openssl Build with GNUTLS (default) or OpenSSL
  --with-ssldir=DIR       SSL base directory for certificates (/etc/ssl)

SSL options.

  --with-pop3d            Build POP3 server (default)

Build pop3d binary. It still has to be separately enabled from configuration

  --with-passwd           Build with /etc/passwd support (default)
  --with-passwd-file      Build with passwd-like file support (default)
  --with-shadow           Build with shadow password support (default)
  --with-pam              Build with PAM support (default)
  --with-ldap             Build with LDAP support
  --with-vpopmail         Build with vpopmail support (default)
  --with-static-userdb    Build with static userdb support (default)
  --with-pgsql            Build with PostgreSQL support

Specify which authentication modules to use. Disabling them give you a few
bytes smaller binary, but not much else.

Dynamic Authentication Modules

Dovecot can also dynamically load authentication modules from
$prefix/lib/dovecot/auth/ directory. Binary packages builders should use
them for auth modules which require external libraries (eg. LDAP and
vpopmail). There's no standard way to build them as modules currently, but
something like this should work:

cd src/auth

-I../.. -I../lib -I../lib-settings \
db-ldap.c userdb-ldap.c passdb-ldap.c -o -lldap

-I../.. -I../lib userdb-vpopmail.c passdb-vpopmail.c -o \

Dynamic IMAP and POP3 Modules

If imap_use_modules or pop3_use_modules is set to yes, Dovecot will load all
*.so modules from directory pointed by imap_modules or pop3_modules. These
modules can do anything, they're only expected to contain <module name>_init
and <module name>_deinit functions which are called.

Dynamic SQL drivers

Currently SQL drivers are only used by dovecot-auth, so you could place
them into same directory with auth plugins.

cd src/lib-sql

-I../.. -I../lib -I../lib-settings -I/usr/include/postgresql \
driver-pgsql.c -o -L/usr/lib/postgresql -lpq

-I../.. -I../lib -I../lib-settings -I/usr/include/mysql \
driver-mysql.c -o -lmysqlclient