annotate INSTALL @ 429:58899a413569 HEAD

Documentation updates.
author Timo Sirainen <tss@iki.fi>
date Tue, 15 Oct 2002 03:45:46 +0300
parents 4c7d08ae3f6e
children b66ccecbc8a6
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
428
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
1 Build instructions
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
2 ------------------
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
3
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
4 For most people, the usual:
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
5
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
6 ./configure
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
7 make
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
8 sudo make install
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
9
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
10 is enough. This installs Dovecot under /usr/local. You must also rename the
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
11 configuration file to get it to work:
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
12
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
13 mv /usr/local/etc/dovecot-example.conf /usr/local/etc/dovecot.conf
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
14
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
15 Read through it, make needed modifications and start imap-master.
429
58899a413569 Documentation updates.
Timo Sirainen <tss@iki.fi>
parents: 428
diff changeset
16 doc/configuration.txt tells you more about configuring Dovecot.
58899a413569 Documentation updates.
Timo Sirainen <tss@iki.fi>
parents: 428
diff changeset
17
428
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
18
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
19 SSL/TLS
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
20 -------
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
21
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
22 GNUTLS v0.5.5 or later is required to enable SSL and TLS support. OpenSSL
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
23 isn't supported. You can get GNUTLS from http://www.gnutls.org/
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
24
429
58899a413569 Documentation updates.
Timo Sirainen <tss@iki.fi>
parents: 428
diff changeset
25
428
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
26 Optional configure options
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
27 --------------------------
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
28
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
29 You can get a full list with:
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
30
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
31 ./configure --help
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
32
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
33 The options are listed like --with-thing or --enable-thing, usually they're
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
34 also enabled by default. You can disable them with --without-thing or
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
35 --disable-thing.
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
36
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
37 Besides the standard options, Dovecot has added these:
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
38
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
39 --enable-ipv6 Enable IPv6 support (default)
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
40
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
41 Enable IPv6 support. By default it's enabled if system is detected to
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
42 support it.
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
43
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
44 --with-file-offset-size=BITS
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
45
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
46 Specifies if we use 32bit or 64bit file offsets. 64bit is default if system
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
47 supports it (Linux and Solaris does). You most likely won't have mails
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
48 larger than 2GB, so you may want to drop this to 32bit for a bit smaller
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
49 disk and memory usage.
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
50
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
51 --with-passwd Build with /etc/passwd support (default)
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
52 --with-passwd-file Build with passwd-like file support (default)
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
53 --with-shadow Build with shadow password support (default)
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
54 --with-pam Build with PAM support (default)
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
55 --with-vpopmail Build with vpopmail support (default)
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
56
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
57 Specify which authentication modules to use. Disabling them give you a few
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
58 bytes smaller binary, but not much else.
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
59
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
60 --with-gnutls Build with GNUTLS (default)
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
61
4c7d08ae3f6e Added installation document
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
62 Use GNUTLS for SSL and TLS support.