diff options
| author | Maximilian Bosch <maximilian@mbosch.me> | 2023-04-13 12:45:06 +0200 |
|---|---|---|
| committer | lewo <lewo@abesis.fr> | 2023-05-14 07:08:27 +0000 |
| commit | e2ca6e45f39045cbc6ce6ad619050e0324a93a23 (patch) | |
| tree | 5b6a6081749d78533ad6c83ff58fd6cc10772c07 | |
| parent | 6d0d9fb966cc565a3df74d3b686f924c7615118c (diff) | |
docs: add instructions for rfc6186-compliant setup
| -rw-r--r-- | docs/autodiscovery.rst | 17 | ||||
| -rw-r--r-- | docs/index.rst | 1 |
2 files changed, 18 insertions, 0 deletions
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 <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. + 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 ================== |