Skip to content

Commit 79f340f

Browse files
committed
config/guides/quick: More simplifications and tweaks
1 parent 197a649 commit 79f340f

File tree

1 file changed

+12
-17
lines changed

1 file changed

+12
-17
lines changed

docs/core/config/guides/quick.md

Lines changed: 12 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -99,9 +99,8 @@ doveconf -nP > dovecot.conf
9999

100100
## Authentication
101101

102-
By default, Dovecot is setup to use system user authentication.
103-
You'll probably be using PAM authentication. See the page [[link,auth_pam]]
104-
for how to configure it.
102+
The above example configures Dovecot to use PAM for system user authentication.
103+
See [[link,auth_pam]] for how to configure it.
105104

106105
A typical configuration with Linux would be to create `/etc/pam.d/dovecot`
107106
which contains:
@@ -121,8 +120,8 @@ Later when you know Dovecot is working, you can do it differently (see
121120
Run as your own non-root user:
122121

123122
```sh
124-
echo "$USER:{PLAIN}password:$UID:$GID::$HOME" > users
125-
sudo mv users /etc/dovecot/
123+
echo "$USER:{PLAIN}password" > passwd
124+
sudo mv passwd /etc/dovecot/
126125

127126
# If SELinux is enabled:
128127
restorecon -v /etc/dovecot/users
@@ -133,21 +132,17 @@ wish to use, but don't use any important password here as we'll be
133132
logging in with insecure plaintext authentication until [[link,ssl]]
134133
is configured.
135134

136-
Switch to passwd-file authentication by adding to `dovecot.conf`:
135+
Switch to passwd-file authentication by replacing `passdb pam` in
136+
`dovecot.conf` with `passdb passwd-file`:
137137

138138
```
139139
passdb passwd-file {
140-
default_password_scheme = CRYPT
141-
passwd_file_path = /etc/dovecot/users
142-
}
143-
144-
userdb passwd-file {
145-
passwd_file_path = /etc/dovecot/users
140+
passwd_file_path = /etc/dovecot/passwd
146141
}
147142
```
148143

149-
Verify with `doveconf -n passdb userdb` that the output looks like
150-
above (and there are no other passdbs or userdbs).
144+
Verify with `doveconf -n passdb` that the output looks like
145+
above (and there are no other passdbs and no userdbs).
151146

152147
If you're using something else, see [[link,passdb]] and [[link,userdb]].
153148

@@ -178,10 +173,10 @@ them than the defaults.
178173

179174
## SSL and Plaintext Authentication
180175

181-
If you intend to use SSL, set [[setting,ssl_cert_file]] and
182-
[[setting,ssl_key_file]] settings. Otherwise set [[setting,ssl,no]].
176+
Configure SSL certificate and private key paths with [[setting,ssl_cert_file]]
177+
and [[setting,ssl_key_file]] settings.
183178

184-
Easiest way to get SSL certificates built is to use Dovecot's
179+
An easy way to build a self-signed test certificate is using Dovecot's
185180
`doc/mkcert.sh` script. For more information see [[link,ssl_configuration]].
186181

187182
By default [[setting,auth_allow_cleartext,no]], which means that Dovecot

0 commit comments

Comments
 (0)