Skip to content

Commit cabf8f1

Browse files
committed
docs(docker-mailserver): document plaintext IMAP exposure risk
Notes the service.exposePlaintextImap toggle added in the previous commit, and why it defaults to false. Signed-off-by: Rishi <rishi@obmondo.com>
1 parent 70cf2cd commit cabf8f1

1 file changed

Lines changed: 16 additions & 0 deletions

File tree

  • argocd-helm-charts/docker-mailserver/charts/docker-mailserver

argocd-helm-charts/docker-mailserver/charts/docker-mailserver/README.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -241,6 +241,22 @@ Enabling the PROXY protocol will create an additional port for each protocol (by
241241

242242
If you do not enable the PROXY protocol and your mail server is not exposed using a load-balancer service with an external traffic policy in "Local" mode, then all incoming mail traffic will look like it comes from a local Kubernetes cluster IP.
243243

244+
### Security: don't expose plaintext IMAP
245+
246+
Enabling IMAP (`ENABLE_IMAP: 1`) makes the chart create Service ports for both plaintext IMAP
247+
(143) and TLS IMAPS (993). If your Service type is `LoadBalancer` or `NodePort`, port 143 is then
248+
reachable from the internet, unencrypted, alongside 993 - this has been caught in production as a
249+
real external exposure.
250+
251+
`service.exposePlaintextImap` defaults to `false`: only IMAPS (993, and its proxy-protocol variant
252+
10993) is exposed on the Service. The container itself still listens on 143 internally; it's just
253+
not published externally unless you explicitly opt in.
254+
255+
```yaml
256+
service:
257+
exposePlaintextImap: false # set true only if a client genuinely cannot do IMAPS
258+
```
259+
244260
[dms-docs::k8s::network-config]: https://docker-mailserver.github.io/docker-mailserver/latest/config/advanced/kubernetes/#exposing-your-mail-server-to-the-outside-world
245261
[dms-docs::k8s::proxy-protocol]: https://docker-mailserver.github.io/docker-mailserver/latest/config/advanced/kubernetes/#proxy-port-to-service-via-proxy-protocol
246262
[k3s-klipperlb-pp]: https://github.com/docker-mailserver/docker-mailserver-helm/issues/176#issuecomment-3097915161

0 commit comments

Comments
 (0)