summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorCorey Hulen <corey@hulen.com>2015-10-12 11:52:42 -0700
committerCorey Hulen <corey@hulen.com>2015-10-12 11:52:42 -0700
commit1ce37c316adceafe2f7409576c378407fe80d7b7 (patch)
treec4b8f31c6f8b5f77bf1ff3fa1d997ffb86999f27
parent535164b5b6c303b1ed8d9d069d48f9284ec25d7a (diff)
parentec2d027455b2e0e1bbfcd8bbfb30e8d94e3bd59e (diff)
downloadchat-1ce37c316adceafe2f7409576c378407fe80d7b7.tar.gz
chat-1ce37c316adceafe2f7409576c378407fe80d7b7.tar.bz2
chat-1ce37c316adceafe2f7409576c378407fe80d7b7.zip
Merge pull request #1015 from mattermost/trouble-shooting-tip
Adding troubleshooting tip
-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 86e2bb20e..8700ac637 100644
--- a/doc/install/SMTP-Email-Setup.md
+++ b/doc/install/SMTP-Email-Setup.md
@@ -39,3 +39,17 @@ To enable email, turn this option off by setting `ByPassEmail=false` and configu
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 receive an error message during SMTP setup, do a web search for the error code number 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 you have 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`.
+
+