diff --git a/docs/_data/sidebars/talk_sidebar.yml b/docs/_data/sidebars/talk_sidebar.yml index 282defcb5..02cac9f3f 100644 --- a/docs/_data/sidebars/talk_sidebar.yml +++ b/docs/_data/sidebars/talk_sidebar.yml @@ -36,6 +36,9 @@ entries: - title: Setup url: /install-setup.html output: web + - title: Troubleshooting + url: /install-troubleshooting.html + output: web - title: Architecture output: web diff --git a/docs/install-troubleshooting.md b/docs/install-troubleshooting.md new file mode 100644 index 000000000..6ff42af05 --- /dev/null +++ b/docs/install-troubleshooting.md @@ -0,0 +1,22 @@ +--- +title: Installation Troubleshooting +keywords: install +sidebar: talk_sidebar +permalink: install-troubleshooting.html +summary: +--- + +This page tracks common issues that arise when installing Talk and provides resolutions. + +## The Talk server seems to be working but the stream isn't showing up on my page. + +Talk employs a _domain whitelist_ that controls which sites can contain comment threads. This prevents malicious folks from using your server to embed streams on unwanted pages. + +If your comment thread isn't showing: + +1. Log into your admin panel +1. Go to the Configure tab +1. Select the Tech Settings submenu +1. Ensure that your Domain is the Permitted Domains list + +Note: if your site has multiple subdomains, listing the domain itself (ie: `mydomain.com`) will enable Talk on all subdomains. If you would like to restrict Talk to certain subdomains, you must list all of them here (ie: `thisone.mydomain.com thatone.mydomain.com`).