add admin pwd reset troubleshooting & manifest updates (#546)

ericpaulsen · Katie Horne · web-flow · commit 3154b2ac55bf · 2021-08-12T14:44:48.000-05:00
* add admin pwd reset troubleshooting &amp; manifest updates

* Edit text; update manifest

Co-authored-by: Katie Horne &lt;katie@coder.com&gt;
diff --git a/guides/troubleshooting/admin-pwd.md b/guides/troubleshooting/admin-pwd.md
@@ -0,0 +1,26 @@
+---
+title: Admin password reset
+description: Learn how to resolve issues with resetting your admin password.
+---
+
+When resetting your Coder admin password in the terminal, you may encounter the
+following error:
+
+```console
+error: unable to upgrade connection: error dialing backend: remote error: tls:
+handshake failure
+```
+
+## Why this happens
+
+This upgrade-related error occurs when a proxy is in front of `kube-apiserver`,
+blocking your attempt to reach the `coderd` pod and reset the admin password.
+
+## Troubleshooting steps
+
+To access the `coderd` pod properly, you'll need to remove the proxy. If
+removing the proxy isn't possible, circumvent the proxy and make the call to
+`coderd` directly using `kubectl`.
+
+If this doesn't resolve the issue, please
+[contact us](https://coder.com/contact) for further support.
diff --git a/guides/troubleshooting/docker-problems.md b/guides/troubleshooting/docker-problems.md
@@ -113,3 +113,6 @@ daemonset.apps "increase-limits" deleted
 
 However, note that the setting will persist until the node restarts or another
 program sets the `kernel.keys.maxkeys` and `kernel.keys.maxkeys` settings.
+
+If this doesn't resolve the issue, please
+[contact us](https://coder.com/contact) for further support.
diff --git a/guides/troubleshooting/git-oauth.md b/guides/troubleshooting/git-oauth.md
@@ -32,3 +32,6 @@ attempts to add your public key again to GitHub.
 If the steps above do not fix the problem, the error may be related to the
 GitHub configuration values set using Coder's **Admin** panel. Site managers can
 view and update these values at **Manage** > **Admin** > **Git OAuth**.
+
+If this doesn't resolve the issue, please
+[contact us](https://coder.com/contact) for further support.
diff --git a/guides/troubleshooting/inotify-watch-limits.md b/guides/troubleshooting/inotify-watch-limits.md
@@ -268,3 +268,6 @@ program sets the `fs.inotify.max_user_watches` setting.
   - [My ultimate VSCode configuration](https://dev.to/vaidhyanathan93/ulitmate-vscode-configuration-4i2o),
     a blog post describing a user's preferred settings, including file
     exclusions
+
+If none of these steps resolve the issue, please
+[contact us](https://coder.com/contact) for further support.
diff --git a/manifest.json b/manifest.json
@@ -383,9 +383,15 @@
         {
           "path": "./guides/troubleshooting/index.md",
           "children": [
+            {
+              "path": "./guides/troubleshooting/admin-pwd.md"
+            },
             {
               "path": "./guides/troubleshooting/docker-problems.md"
             },
+            {
+              "path": "./guides/troubleshooting/git-oauth.md"
+            },
             {
               "path": "./guides/troubleshooting/registry.md"
             },

Original file line number	Diff line number	Diff line change
`@@ -383,9 +383,15 @@`
`383`	`383`	`{`
`384`	`384`	`"path": "./guides/troubleshooting/index.md",`
`385`	`385`	`"children": [`
	`386`	`+ {`
	`387`	`+ "path": "./guides/troubleshooting/admin-pwd.md"`
	`388`	`+ },`
`386`	`389`	`{`
`387`	`390`	`"path": "./guides/troubleshooting/docker-problems.md"`
`388`	`391`	`},`
	`392`	`+ {`
	`393`	`+ "path": "./guides/troubleshooting/git-oauth.md"`
	`394`	`+ },`
`389`	`395`	`{`
`390`	`396`	`"path": "./guides/troubleshooting/registry.md"`
`391`	`397`	`},`