Add SMTP troubleshoot case (#7678)

* Add SMTP troubleshoot case Remind to check System Console > Notifications setting in case of SMTP issue "Failed to set the to address" * Update source/configure/smtp-email.rst * Clarify SMTP error case occurrence location * Update source/configure/smtp-email.rst --------- Co-authored-by: Carrie Warner (Mattermost) <[email protected]>
mattermost · Jan 6, 2025 · dd7bcae · dd7bcae
1 parent 1ed2195
commit dd7bcae
Showing 1 changed file with 6 additions and 1 deletion.
diff --git a/source/configure/smtp-email.rst b/source/configure/smtp-email.rst
@@ -109,6 +109,11 @@ For example, if **System Console > Logs** displays the following error, search f
 
   Connection unsuccessful: Failed to add to email address - 554 5.7.1 <unknown[IP-ADDRESS]>: Client host rejected: Access denied
 
+Checking your Notifications settings
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If an SMTP connection test in the System Console for a self-hosted Mattermost deployment fails with the message ``Connection unsuccessful: Failed to set the to address: 550 5.7.27 <[email protected]>``, go to **System Console > Site Configuration > Notifications** to verify that notification settings are configured correctly, including **Notification Display Name**, **Notification From Address**, **Support Email Address**, and **Notification Reply-To Address**. Cloud administrators can't manage **Notification From Address** or **Notification Reply-To Address**.
+
 Checking your SMTP server is reachable 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -134,4 +139,4 @@ Checking your SMTP server is reachable
 .. note:: 
 
   - Telnet isn't included in official Mattermost Docker images, so you either need to use ``ping`` on those, or install Telnet yourself either directly or by modifying the Dockerfile.
-  - For further assistance, review the `Troubleshooting forum <https://forum.mattermost.com/c/trouble-shoot/16>`_ for previously reported errors, or `join the Mattermost user community for troubleshooting help <https://mattermost.com/community/>`_.
+  - For further assistance, review the `Troubleshooting forum <https://forum.mattermost.com/c/trouble-shoot/16>`_ for previously reported errors, or `join the Mattermost user community for troubleshooting help <https://mattermost.com/community/>`_.