diff --git a/docs/docs/guides/02-installation/01-mac.md b/docs/docs/guides/02-installation/01-mac.md
index 90a2c4c18..ab8622164 100644
--- a/docs/docs/guides/02-installation/01-mac.md
+++ b/docs/docs/guides/02-installation/01-mac.md
@@ -50,7 +50,7 @@ jan-mac-arm64-{version}.zip
## Uninstall Jan
-As Jan is development mode, you might get stuck on a broken build
+As Jan is development mode, you might get stuck on a broken build.
To reset your installation
1. Delete Jan from your `/Applications` folder
diff --git a/docs/docs/guides/02-installation/03-linux.md b/docs/docs/guides/02-installation/03-linux.md
index 48ca12563..7f0db2b78 100644
--- a/docs/docs/guides/02-installation/03-linux.md
+++ b/docs/docs/guides/02-installation/03-linux.md
@@ -42,10 +42,10 @@ jan-linux-amd64-{version}.deb
## Uninstall Jan
-To uninstall VS Code on Linux, you should use your package manager's uninstall or remove option. For Debian/Ubuntu-based distributions, if you installed Jan via the `.deb` package, you can uninstall Jan using the following command:
+To uninstall Jan on Linux, you should use your package manager's uninstall or remove option. For Debian/Ubuntu-based distributions, if you installed Jan via the `.deb` package, you can uninstall Jan using the following command:
```bash
-sudo apt-get remove jan`
+sudo apt-get remove jan
# where jan is the name of Jan package
```
diff --git a/docs/docs/guides/07-troubleshooting/01-stuck-on-broken-build.mdx b/docs/docs/guides/07-troubleshooting/01-stuck-on-broken-build.mdx
new file mode 100644
index 000000000..011b05480
--- /dev/null
+++ b/docs/docs/guides/07-troubleshooting/01-stuck-on-broken-build.mdx
@@ -0,0 +1,121 @@
+---
+title: Stuck on a Broken Build
+slug: /troubleshooting/stuck-on-broken-build
+description: Jan is a ChatGPT-alternative that runs on your own computer, with a local API server.
+keywords:
+ [
+ Jan AI,
+ Jan,
+ ChatGPT alternative,
+ local AI,
+ private AI,
+ conversational AI,
+ no-subscription fee,
+ large language model,
+ troubleshooting,
+ ]
+---
+
+{/* Imports */}
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+The following steps will help you troubleshoot and resolve issues related to broken builds.
+
+1. Unistall Jan
+
+
+
+
+ Delete Jan from your `/Applications` folder
+
+
+
+
+ To uninstall Jan in Windows, use the [Windows Control Panel](https://support.microsoft.com/en-us/windows/uninstall-or-remove-apps-and-programs-in-windows-4b55f974-2cc6-2d2b-d092-5905080eaf98).
+
+
+
+
+ To uninstall Jan on Linux, you should use your package manager's uninstall or remove option. For Debian/Ubuntu-based distributions, if you installed Jan via the `.deb` package, you can uninstall Jan using the following command:
+ ```bash
+ sudo apt-get remove jan
+ ```
+
+
+
+
+2. Delete the application data, cache, and user data folders
+
+
+
+
+ ```bash
+ # Step 1: Delete the application data
+ ## Newer versions
+ rm -rf /Users/$(whoami)/Library/Application\ Support/jan
+ ## Versions 0.2.0 and older
+ rm -rf /Users/$(whoami)/Library/Application\ Support/jan-electron
+
+ # Step 2: Clear application cache
+ rm -rf /Users/$(whoami)/Library/Caches/jan*
+
+ # Step 3: Remove all user data
+ rm -rf ./jan
+ ```
+
+
+
+
+ ```bash
+ # You can delete the `/Jan` directory in Windows's AppData Directory by visiting the following path `%APPDATA%\Jan`
+ cd C:\Users\%USERNAME%\AppData\Roaming
+ rm -rf ./Jan
+ ```
+
+
+
+
+ ```bash
+ # You can delete the user data folders located at the following `$HOME/.config/jan` and `~/.jan`
+ rm -r $HOME/.config/jan
+ rm -r ~/.jan
+ ```
+
+
+
+
+3. If you are using version before `0.4.2` you need to run the following commands
+
+
+
+
+ ```bash
+ ps aux | grep nitro
+ # Looks for processes like `nitro` and `nitro_arm_64`, and kill them one by one by process ID
+ kill -9
+ ```
+
+
+
+
+ ```bash
+ # Find the process ID (PID) of the nitro process by filtering the list by process name
+ tasklist | findstr "nitro"
+ # Once you have the PID of the process you want to terminate, run the `taskkill`
+ taskkill /F /PID
+ ```
+
+
+
+
+ ```bash
+ ps aux | grep nitro
+ # Looks for processes like `nitro` and `nitro_arm_64`, and kill them one by one by process ID
+ kill -9
+ ```
+
+
+
+
+4. Download the latest version from via our homepage, [https://jan.ai/](https://jan.ai/).
diff --git a/docs/docs/guides/07-troubleshooting/README.md b/docs/docs/guides/07-troubleshooting/README.md
new file mode 100644
index 000000000..9662ac078
--- /dev/null
+++ b/docs/docs/guides/07-troubleshooting/README.md
@@ -0,0 +1,3 @@
+---
+title: Troubleshooting
+---