From 41aee6a0ef00ea317b614ae647e65615e21247a2 Mon Sep 17 00:00:00 2001
From: Ho Duc Hieu <150573299+hieu-jan@users.noreply.github.com>
Date: Fri, 22 Dec 2023 15:03:56 +0900
Subject: [PATCH] docs: add troubleshooting

---
 docs/docs/guides/02-installation/03-linux.md  |  2 +-
 .../01-stuck-on-broken-build.md               | 53 +++++++++++++++++++
 docs/docs/guides/07-troubleshooting/README.md |  3 ++
 3 files changed, 57 insertions(+), 1 deletion(-)
 create mode 100644 docs/docs/guides/07-troubleshooting/01-stuck-on-broken-build.md
 create mode 100644 docs/docs/guides/07-troubleshooting/README.md

diff --git a/docs/docs/guides/02-installation/03-linux.md b/docs/docs/guides/02-installation/03-linux.md
index 48ca12563..b4b3d0960 100644
--- a/docs/docs/guides/02-installation/03-linux.md
+++ b/docs/docs/guides/02-installation/03-linux.md
@@ -45,7 +45,7 @@ jan-linux-amd64-{version}.deb
 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:
 
 ```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.md b/docs/docs/guides/07-troubleshooting/01-stuck-on-broken-build.md
new file mode 100644
index 000000000..51d6c848a
--- /dev/null
+++ b/docs/docs/guides/07-troubleshooting/01-stuck-on-broken-build.md
@@ -0,0 +1,53 @@
+---
+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,
+  ]
+---
+
+The following steps will help you troubleshoot and resolve issues related to broken builds.
+
+1. Delete the application data
+
+```bash
+# 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
+```
+
+2. Clear application cache
+
+```bash
+rm -rf /Users/$(whoami)/Library/Caches/jan*
+```
+
+3. Remove user data
+
+```bash
+rm -rf ./jan
+```
+
+4. Delete Jan from your `/Applications` folder
+
+5. 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 <PID>
+```
+
+6. 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
+---