summaryrefslogtreecommitdiffstats
path: root/doc/install/SMTP-Email-Setup.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/install/SMTP-Email-Setup.md')
-rw-r--r--doc/install/SMTP-Email-Setup.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/install/SMTP-Email-Setup.md b/doc/install/SMTP-Email-Setup.md
index b908d04dd..8bf094714 100644
--- a/doc/install/SMTP-Email-Setup.md
+++ b/doc/install/SMTP-Email-Setup.md
@@ -44,3 +44,17 @@ To enable email, turn this option on by setting `SendEmailNotifications=true` an
2. Kill the process `kill pid`
3. The service should restart automatically. Verify the Mattermost service is running with `ps -A`
4. Current logged in users will not be affected, but upon logging out or session expiration users will be required to verify their email address.
+
+### Troubleshooting SMTP
+
+If you have issues with your SMTP install, from your Mattermost team site go to the main menu and open `System Console > Logs` to look for error messages related to your setup. You can do a search for the error code to narrow down the issue. Sometimes ISPs require nuanced setups for SMTP and error codes can hint at how to make the proper adjustments.
+
+For example, if `System Console > Logs` has an error code reading:
+
+```
+Connection unsuccessful: Failed to add to email address - 554 5.7.1 <unknown[IP-ADDRESS]>: Client host rejected: Access denied
+```
+
+Search for `554 5.7.1 error` and `Client host rejected: Access denied`.
+
+