Skip to content

add admin pwd reset troubleshooting & manifest updates #546

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Aug 12, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions guides/troubleshooting/admin-pwd.md
Original file line number Diff line number Diff line change
@@ -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.
3 changes: 3 additions & 0 deletions guides/troubleshooting/docker-problems.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
3 changes: 3 additions & 0 deletions guides/troubleshooting/git-oauth.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
3 changes: 3 additions & 0 deletions guides/troubleshooting/inotify-watch-limits.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
6 changes: 6 additions & 0 deletions manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
},
Expand Down