← Back to branch summary

~ubuntu-branches/ubuntu/trusty/dovecot/trusty-updates

« back to all changes in this revision

Viewing changes to doc/wiki/QuickConfiguration.txt

  • Committer: Package Import Robot
  • Author(s): James Page
  • Date: 2014-01-08 09:35:49 UTC
  • mfrom: (1.15.3) (96.1.1 trusty-proposed)
  • Revision ID: package-import@ubuntu.com-20140108093549-814nkqdcxfbvgktg
Tags: 1:2.2.9-1ubuntu1
* Merge from Debian unstable, remaining changes:
  + Add mail-stack-delivery package:
    - Update d/rules
    - d/control: convert existing dovecot-postfix package to a dummy
      package and add new mail-stack-delivery package.
    - Update maintainer scripts.
    - Rename d/dovecot-postfix.* to debian/mail-stack-delivery.*
    - d/mail-stack-delivery.preinst: Move previously installed backups and
      config files to a new package namespace.
    - d/mail-stack-delivery.prerm: Added to handle downgrades.
  + Use Snakeoil SSL certificates by default:
    - d/control: Depend on ssl-cert.
    - d/dovecot-core.postinst: Relax grep for SSL_* a bit.
  + Add autopkgtest to debian/tests/*.
  + Add ufw integration:
    - d/dovecot-core.ufw.profile: new ufw profile.
    - d/rules: install profile in dovecot-core.
    - d/control: dovecot-core - suggest ufw.
  + d/dovecot-core.dirs: Added usr/share/doc/dovecot-core
  + Add apport hook:
    - d/rules, d/source_dovecot.py
  + Add upstart job:
    - d/rules, d/dovecot-core.dovecot.upstart, d/control,
      d/dovecot-core.dirs, dovecot-imapd.{postrm, postinst, prerm},
      d/dovecot-pop3d.{postinst, postrm, prerm}.
      d/mail-stack-deliver.postinst: Convert init script to upstart.
  + Use the autotools-dev dh addon to update config.guess/config.sub for
    arm64.
* Dropped changes, included in Debian:
  - Update Dovecot name to reflect distribution in login greeting.
  - Update Drac plugin for >= 2.0.0 support.
* d/control: Drop dovecot-postfix package as its no longer required.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/wiki/QuickConfiguration.txt
11
11
 
12
12
     1. Configuration file
13
13
 
 
14
         1. Installing from sources
 
15
 
 
16
         2. Split configuration files
 
17
 
14
18
     2. Authentication
15
19
 
16
20
     3. Mail Location
30
34
Configuration file
31
35
------------------
32
36
 
 
37
Prebuilt packages usually install the configuration files into '/etc/dovecot/'.
 
38
You'll find the correct path by running:
 
39
 
 
40
---%<-------------------------------------------------------------------------
 
41
doveconf -n | head -n 1
 
42
---%<-------------------------------------------------------------------------
 
43
 
 
44
It's a good idea to read through all the config files and see what settings you
 
45
might want to change.
 
46
 
 
47
Installing from sources
 
48
-----------------------
 
49
 
33
50
If you compiled and installed Dovecot from sources, Dovecot has installed only
34
51
a '/usr/local/etc/dovecot/README' file, which contains the path to the
35
52
installed example configuration files, usually
36
 
'/usr/local/share/doc/dovecot/example-config'. Copy the 'dovecot.conf' file and
37
 
'conf.d' directory from the example-config directory into
38
 
'/usr/local/etc/dovecot/'. Prebuilt packages usually install the configuration
39
 
files directly into '/etc/dovecot/'.
40
 
 You'll find the path by running 'doveconf -n | head -n 1'.
41
 
 It's a good idea to read through all the files and see what settings you might
42
 
want to change.
 
53
'/usr/local/share/doc/dovecot/example-config'. Copy them to etc/:
 
54
 
 
55
---%<-------------------------------------------------------------------------
 
56
cp -r /usr/local/share/doc/dovecot/example-config/* /usr/local/etc/dovecot/
 
57
---%<-------------------------------------------------------------------------
 
58
 
 
59
Split configuration files
 
60
-------------------------
43
61
 
44
62
The default configuration starts from 'dovecot.conf', which contains an
45
 
'!include conf.d/*.conf' statement to read the rest of the configuration. This
46
 
split of configuration files isn't a requirement to use, and it doesn't really
47
 
matter which .conf file you add any particular setting, just as long as it
48
 
isn't overridden in another file. You can verify with 'doveconf -n' that
49
 
everything looks as you intended.
 
63
'!include conf.d/*.conf' statement to read the rest of the configuration. The
 
64
idea is that the settings are nicely grouped into different files to make it
 
65
easier for new admins to scan through related settings. It doesn't matter which
 
66
config file you add which setting. In the production system it's often easier
 
67
to just have a single 'dovecot.conf' file, which you can create easily using
 
68
 
 
69
---%<-------------------------------------------------------------------------
 
70
doveconf -n > dovecot.conf
 
71
---%<-------------------------------------------------------------------------
50
72
 
51
73
Authentication
52
74
--------------
104
126
'ssl = no'. Easiest way to get SSL certificates built is to use Dovecot's
105
127
'doc/mkcert.sh' script. See <SSL.txt>.
106
128
 
107
 
By default Dovecot doesn't allow users to send passwords unencrypted to the
108
 
server. Usually if SSL is enabled, it's a good idea not to allow this. However,
109
 
if you don't offer SSL for some reason, you'll probably want to set
110
 
'disable_plaintext_auth = no'.
 
129
By default 'disable_plaintext_auth = yes', which means that Dovecot will fail
 
130
the authentication if the client doesn't use SSL (or use <non-plaintext
 
131
authentication> [Authentication.Mechanisms.txt]). This is recommended in most
 
132
situations, since it prevents leaking passwords. However, if you don't offer
 
133
SSL for some reason, you'll probably want to set 'disable_plaintext_auth = no'.
111
134
 
112
135
NFS
113
136
---
120
143
 
121
144
See <RunningDovecot.txt> and <Logging.txt>.
122
145
 
123
 
(This file was created from the wiki on 2012-04-23 04:42)
 
146
(This file was created from the wiki on 2013-11-24 04:42)