Create Troubleshooting doc (#1411)

* Create Troubleshooting doc * Add Toc entry for new doc * Update README.md
RocketChat · Sep 24, 2019 · 8151c47 · 8151c47
1 parent 5c5307b
commit 8151c47
Show file tree

Hide file tree

Showing 2 changed files with 17 additions and 0 deletions.
diff --git a/_data/toc.yml b/_data/toc.yml
@@ -179,6 +179,7 @@
   - Retention Policies
   - Settings Via Env Vars
   - Youtube Broadcasting
+  - Troubleshooting
 - Developer guides:
     - Quick Start
     - Branches and Releases

diff --git a/administrator-guides/troubleshooting/README.md b/administrator-guides/troubleshooting/README.md
@@ -0,0 +1,16 @@
+# Troubleshooting
+
+Sometimes we get ourselves into a bit of trouble.  Here we will try to provide common problems and their solutions.
+
+## Invalid Site URL Warning
+
+If you receive an alert that you have an invalid Site URL.  This means that some how your Site URL and the URL you are accessing from don't match.  This causes assets in Rocket.Chat to not be able to load properly.
+
+This usually happens when someone changes the setting.  To resolve this you will need to modify the site url.
+
+Setting the following environment variables will correct this issue:
+
+```
+OVERWRITE_SETTING_Site_Url=https://the-address-you-use-to-access
+ROOT_URL=https://the-address-you-use-to-access
+```