Nicholai/jan
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: improve troubleshooting docs

Browse Source
This commit is contained in:
Ho Duc Hieu 2023-12-22 15:59:02 +09:00
parent 41aee6a0ef
commit a3f77c775b
3 changed files with 97 additions and 54 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/docs/guides/02-installation/03-linux.md
View File

@ -42,7 +42,7 @@ 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

53
docs/docs/guides/07-troubleshooting/01-stuck-on-broken-build.md
View File

@ -1,53 +0,0 @@
---
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/).

96
docs/docs/guides/07-troubleshooting/01-stuck-on-broken-build.mdx Normal file
View File

@ -0,0 +1,96 @@
---
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
<Tabs groupId="operating-systems">
<TabItem value="mac" label="macOS">
Delete Jan from your `/Applications` folder
</TabItem>
<TabItem value="win" label="Windows">
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).
</TabItem>
<TabItem value="linux" label="Linux">
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
```
</TabItem>
</Tabs>
2. Delete the application data, cache, and user data folders
<Tabs groupId="operating-systems">
<TabItem value="mac" label="macOS">
```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
```
</TabItem>
<TabItem value="win" label="Windows">
```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
```
</TabItem>
<TabItem value="linux" label="Linux">
```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
```
</TabItem>
</Tabs>
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 <PID>
```
3. Download the latest version from via our homepage, [https://jan.ai/](https://jan.ai/).