diff --git a/docs/autodiscovery.rst b/docs/autodiscovery.rst new file mode 100644 index 0000000..7f4d438 --- /dev/null +++ b/docs/autodiscovery.rst @@ -0,0 +1,17 @@ +Autodiscovery +============= + +`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 `_ can be used instead. + diff --git a/docs/index.rst b/docs/index.rst index b8700ff..717eed0 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -29,6 +29,7 @@ Welcome to NixOS Mailserver's documentation! rspamd-tuning fts flakes + autodiscovery Indices and tables ==================