Skip to content

Commit e5ecd25

Browse files
committed
guides/quick: Minor tweaks to quick configuration example
Reorder the settings to make more sense. Update comments. Remove the lower-filter from %{user}, because the default auth_username_format already lowercases the user. Add dovecot_*_version settings.
1 parent 52dd5a0 commit e5ecd25

File tree

1 file changed

+15
-10
lines changed

1 file changed

+15
-10
lines changed

docs/core/config/guides/quick.md

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -26,14 +26,20 @@ You need to create group `vmail` and user `vmail`.
2626

2727
::: code-group
2828
```[dovecot.conf]
29-
mail_home = /srv/mail/%{user | lower}
29+
# Start new configs with the latest Dovecot version numbers here:
30+
dovecot_config_version = 3.1.0
31+
dovecot_storage_version = 3.1.0
32+
33+
mail_home = /srv/mail/%{user}
3034
mail_driver = sdbox
3135
mail_path = ~/Mail
3236
33-
## this is sometimes needed
34-
#first_valid_uid = uid-of-vmail-user
37+
namespace {
38+
inbox = yes
39+
separator = /
40+
}
3541
36-
# if you want to use system users
42+
# Use system users:
3743
passdb pam {
3844
driver = pam
3945
}
@@ -42,19 +48,18 @@ userdb passwd {
4248
driver = passwd
4349
use_worker = yes
4450
fields {
51+
# Override users' UID and GID to vmail:
4552
uid = vmail
4653
gid = vmail
4754
}
4855
}
4956
50-
ssl=yes
57+
## this is sometimes needed
58+
#first_valid_uid = uid-number-of-vmail-user
59+
60+
ssl = yes
5161
ssl_cert_file = /path/to/cert.pem
5262
ssl_key_file = /path/to/key.pem
53-
54-
namespace {
55-
inbox = yes
56-
separator = /
57-
}
5863
```
5964
:::
6065

0 commit comments

Comments
 (0)