From 525d9f0e15d6e4d764ec30b5d3c8830899934374 Mon Sep 17 00:00:00 2001
From: polarathene <5098581+polarathene@users.noreply.github.com>
Date: Wed, 31 Jan 2024 17:00:03 +1300
Subject: [PATCH] docs: Add LDAP compatibility caveat for `RELAY_HOST`

---
 docs/content/config/advanced/mail-forwarding/aws-ses.md     | 2 +-
 docs/content/config/advanced/mail-forwarding/relay-hosts.md | 2 +-
 docs/content/config/environment.md                          | 2 ++
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/content/config/advanced/mail-forwarding/aws-ses.md b/docs/content/config/advanced/mail-forwarding/aws-ses.md
index 866b4185..00ca2a13 100644
--- a/docs/content/config/advanced/mail-forwarding/aws-ses.md
+++ b/docs/content/config/advanced/mail-forwarding/aws-ses.md
@@ -15,7 +15,7 @@ title: 'Mail Forwarding | AWS SES'
     ```env
     RELAY_HOST=email-smtp.us-west-2.amazonaws.com
     RELAY_PORT=587
-    # Alternative to RELAY_HOST + RELAY_PORT:
+    # Alternative to RELAY_HOST + RELAY_PORT which is compatible with LDAP:
     DEFAULT_RELAY_HOST=[email-smtp.us-west-2.amazonaws.com]:587
 
     RELAY_USER=aws-user
diff --git a/docs/content/config/advanced/mail-forwarding/relay-hosts.md b/docs/content/config/advanced/mail-forwarding/relay-hosts.md
index 4caa82dd..7ef8238c 100644
--- a/docs/content/config/advanced/mail-forwarding/relay-hosts.md
+++ b/docs/content/config/advanced/mail-forwarding/relay-hosts.md
@@ -22,8 +22,8 @@ All mail sent outbound from DMS (_where the sender address is a DMS account or a
 
     Configure the default relayhost with either of these ENV:
 
+    - Preferable (_LDAP compatible_): `DEFAULT_RELAY_HOST` (eg: `[mail.relay-service.com]:25`)
     - `RELAY_HOST` (eg: `mail.relay-service.com`) + `RELAY_PORT` (default: 25)
-    - `DEFAULT_RELAY_HOST` (eg: `[mail.relay-service.com]:25`)
 
     Most relay services also require authentication configured:
 
diff --git a/docs/content/config/environment.md b/docs/content/config/environment.md
index 93d38bd0..d04da022 100644
--- a/docs/content/config/environment.md
+++ b/docs/content/config/environment.md
@@ -1020,6 +1020,8 @@ Supported ENV for the [Relay Host][docs::relay-host] feature.
 
     This is advised unless you need support for sender domain opt-out (via `setup relay exclude-domain`).
 
+    The implementation for `RELAY_HOST` is not compatible with LDAP.
+
 !!! tip "Opt-in for relay host support"
 
     Enable relaying only for specific sender domains instead by using `setup relay add-domain`.