From ed1970b6d81cc0702fba60ed69b6b7bd2cabb7c5 Mon Sep 17 00:00:00 2001
From: Neeraj Gupta <254676+ua741@users.noreply.github.com>
Date: Fri, 30 Aug 2024 14:51:43 +0530
Subject: [PATCH] [docs] Add troubleshooting guide for auth

---
 docs/docs/.vitepress/sidebar.ts               |  9 ++++
 .../auth/troubleshooting/windows-login.md     | 43 +++++++++++++++++++
 2 files changed, 52 insertions(+)
 create mode 100644 docs/docs/auth/troubleshooting/windows-login.md

diff --git a/docs/docs/.vitepress/sidebar.ts b/docs/docs/.vitepress/sidebar.ts
index 62b3cedf87..35eac00fd5 100644
--- a/docs/docs/.vitepress/sidebar.ts
+++ b/docs/docs/.vitepress/sidebar.ts
@@ -205,6 +205,15 @@ export const sidebar = [
                     },
                 ],
             },
+            {
+                text: "Troubleshooting",
+                items: [
+                    {
+                        text: "Windows login",
+                        link: "/auth/troubleshooting/windows-login",
+                    },
+                ],
+            },
         ],
     },
     {
diff --git a/docs/docs/auth/troubleshooting/windows-login.md b/docs/docs/auth/troubleshooting/windows-login.md
new file mode 100644
index 0000000000..2a990fc7af
--- /dev/null
+++ b/docs/docs/auth/troubleshooting/windows-login.md
@@ -0,0 +1,43 @@
+---
+title: Unable to login on Windows Desktop
+description:
+    Troubleshooting when you are not able to login or register on Ente Auth app on Windows
+---
+
+
+
+# Windows Login Error
+
+
+### HandshakeException: Handshake error in client
+
+This error usually happens when the Trusted Root certificates on your Windows machine are outdated.
+
+To update the Trusted Root Certificates on Windows, you can use the `certutil` command. Here are the steps to do so:
+
+1. **Open Command Prompt as Administrator**: 
+   - Press `Windows + X` and select `Command Prompt (Admin)` or `Windows PowerShell (Admin)`.
+
+2. **Run the following command to update the root certificates**:
+   ```bash
+   certutil -generateSSTFromWU roots.sst
+   ```
+   This command will generate a file named `roots.sst` that contains the latest root certificates from Windows Update.
+
+3. **Install the new root certificates**:
+   ```bash
+   certutil -addstore -f ROOT roots.sst
+   ```
+   This command will add the certificates from the `roots.sst` file to the Trusted Root Certification Authorities store.
+
+4. **Clean up**: 
+   After the installation, you can delete the `roots.sst` file if you no longer need it:
+   ```bash
+   del roots.sst
+   ```
+
+Make sure to restart your application after updating the certificates to ensure the changes take effect.
+
+If the above steps don't resolve the issue, please follow [this guide](https://woshub.com/updating-trusted-root-certificates-in-windows-10/#h2_3) to update your trusted root certicates, and try again.
+
+