diff --git a/guides/troubleshooting/admin-pwd.md b/guides/troubleshooting/admin-pwd.md new file mode 100644 index 000000000..2452b5e7f --- /dev/null +++ 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 index 1a60a1017..a53b52532 100644 --- 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 index 0cfd5902f..73934ec71 100644 --- 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 index d29d587bc..54f8c5d84 100644 --- 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 index 16672a387..8a7fdb4c7 100644 --- 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" },