docs: add instructions for rfc6186-compliant setup

This commit is contained in:
Maximilian Bosch 2023-04-13 12:45:06 +02:00 committed by lewo
parent 6d0d9fb966
commit e2ca6e45f3
2 changed files with 18 additions and 0 deletions

17
docs/autodiscovery.rst Normal file
View file

@ -0,0 +1,17 @@
Autodiscovery
=============
`RFC6186 <https://www.rfc-editor.org/rfc/rfc6186>`_ allows supporting email clients to automatically discover SMTP / IMAP addresses
of the mailserver. For that, the following records are required:
================ ==== ==== ======== ====== ==== =================
Record TTL Type Priority Weight Port Value
================ ==== ==== ======== ====== ==== =================
_submission._tcp 3600 SRV 5 0 587 mail.example.com.
_imap._tcp 3600 SRV 5 0 143 mail.example.com.
_imaps._tcp 3600 SRV 5 0 993 mail.example.com.
================ ==== ==== ======== ====== ==== =================
Please note that only a few MUAs currently implement this. For vendor-specific
discovery mechanisms `automx <https://github.com/rseichter/automx2>`_ can be used instead.

View file

@ -29,6 +29,7 @@ Welcome to NixOS Mailserver's documentation!
rspamd-tuning rspamd-tuning
fts fts
flakes flakes
autodiscovery
Indices and tables Indices and tables
================== ==================