From e2ca6e45f39045cbc6ce6ad619050e0324a93a23 Mon Sep 17 00:00:00 2001 From: Maximilian Bosch Date: Thu, 13 Apr 2023 12:45:06 +0200 Subject: [PATCH] docs: add instructions for rfc6186-compliant setup --- docs/autodiscovery.rst | 17 +++++++++++++++++ docs/index.rst | 1 + 2 files changed, 18 insertions(+) create mode 100644 docs/autodiscovery.rst 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 ==================