Skip to content

Commit 238c0d6

Browse files
committed
installation/docker: Improve documentation
1 parent 40a82f3 commit 238c0d6

File tree

1 file changed

+23
-5
lines changed

1 file changed

+23
-5
lines changed

docs/installation/docker.md

Lines changed: 23 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -41,8 +41,6 @@ Example:
4141
docker run -v /etc/dovecot-config:/etc/dovecot/conf.d:ro -v /srv/vmail:/srv/vmail -p 143:31143 -p 993:31993 dovecot/dovecot:latest
4242
```
4343

44-
Dovecot uses TLS certificates from `/etc/dovecot/ssl` directory. The full chain certificate name is expected to be `tls.crt`, and key file `tls.key`.
45-
4644
POP3 service is not enabled by default, if you need pop3, place a pop3.conf drop-in to conf.d:
4745

4846
```
@@ -53,6 +51,26 @@ protocols {
5351

5452
By default imap, submission, lmtp and sieve protocols are enabled.
5553

54+
### Authentication
55+
56+
The default auth configuration is in conf.d/auth.conf, which has
57+
```
58+
passdb static {
59+
password = $ENV:USER_PASSWORD
60+
}
61+
```
62+
63+
This is useful only for testing purposes and single-user instances. To configure multiple users or other authentication methods, you need to override this file.
64+
65+
### TLS configuration
66+
67+
Default certificate is expected at `/etc/dovecot/ssl/tls.crt` and key at `/etc/dovecot/ssl/tls.key`. You can override `conf.d/ssl.conf` to change thi.s
68+
69+
### Complex configuration
70+
71+
You can also override the entire `/etc/dovecot/dovecot.conf` file, just make sure you include `/etc/dovecot/vendor.d/rootless.conf` in your configuration either
72+
direcly, or via include. This is not needed if you use the `-root` variant image.
73+
5674
## Listening ports
5775

5876
Since v2.4.1 ports are exposed as non-privileged ports. You need to map these
@@ -65,7 +83,7 @@ to the ports that you need.
6583
| imap | 31143 |
6684
| imaps | 31993 |
6785
| pop3 | 31110 |
68-
| pop3s | 31990 |
86+
| pop3s | 31995 |
6987
| submissions | 31465 |
7088
| submission | 31587 |
7189
| lmtps | 31024 |
@@ -81,12 +99,12 @@ To run the system fully read-only, use:
8199
docker run --read-only --tmpfs /tmp --tmpfs /run/dovecot -v /srv/vmail:/srv/vmail --rm -it dovecot/dovecot:latest
82100
```
83101

84-
Dovecot will need write permissions to `/tmp`, `/run` and persistent mail storage at `/srv/vmail`.
102+
Dovecot will need write permissions to `/tmp`, `/run/dovecot` and persistent mail storage at `/srv/vmail`.
85103

86104
## Running without Linux capabilities
87105

88106
By default, Dovecot needs `CAP_SYS_CHROOT` capability. To remove this requirements, you can prevent chrooting
89-
by placing no-chroot.conf to drop-in directory:
107+
by placing no-chroot.conf to `conf.d` directory:
90108

91109
```
92110
service submission-login {

0 commit comments

Comments
 (0)