Linux
Instructions for installing Jan on Linux.
Compatibility
Section titled “Compatibility”System requirements:
Debian-based (Supports .deb
and AppImage
)
Section titled “Debian-based (Supports .deb and AppImage)”- Debian
- Ubuntu and derivatives:
- Ubuntu Desktop LTS (official)/Ubuntu Server LTS (only for server)
- Edubuntu
- Kubuntu
- Lubuntu
- Ubuntu Budgie
- Ubuntu Cinnamon
- Ubuntu Kylin
- Ubuntu MATE
- Linux Mint
- Pop!_OS
RHEL-based (Supports .rpm
and AppImage
)
Section titled “RHEL-based (Supports .rpm and AppImage)”- RHEL-based (Server only)
- Fedora
Arch-based
Section titled “Arch-based”- Arch Linux
- SteamOS
Independent
Section titled “Independent”- openSUSE
- Haswell processors (Q2 2013) and newer
- Tiger Lake (Q3 2020) and newer for Celeron and Pentium processors
- Excavator processors (Q2 2015) and newer
- 8GB → up to 3B parameter models (int4)
- 16GB → up to 7B parameter models (int4)
- 32GB → up to 13B parameter models (int4)
- 6GB → up to 3B parameter models (int4)
- 8GB → up to 7B parameter models (int4)
- 12GB → up to 13B parameter models (int4)
Minimum 10GB of free disk space required.
Install Jan
Section titled “Install Jan”Installation steps:
Step 1: Download Application
Section titled “Step 1: Download Application”Available releases:
Stable release:
- Ubuntu: jan.deb
- Others: Jan.AppImage
- Official Website: https://jan.ai/download
Development build:
- Ubuntu: jan.deb
- Others: Jan.AppImage
Step 2: Install Application
Section titled “Step 2: Install Application”Installation commands:
sudo dpkg -i jan-linux-amd64-{version}.deb
apt-get
Section titled “apt-get”sudo apt-get install ./jan-linux-amd64-{version}.deb
From the terminal, run the following commands:
chmod +x jan-linux-x86_64-{version}.AppImage./jan-linux-x86_64-{version}.AppImage
Data Folder
Section titled “Data Folder”Default locations:
# Custom installation directory$XDG_CONFIG_HOME = /home/username/custom_config
# or
# Default installation directory~/.config/Jan/data
See Jan Data Folder for details.
GPU Acceleration
Section titled “GPU Acceleration”Configuration for GPU support:
- Install the NVIDIA Driver, ideally via your package manager.
- Verify:
- Install the CUDA toolkit, ideally from your package manager (11.7+)
- Verify:
- Navigate to Settings > Local Engine > Llama.cpp
- Select appropriate backend in llama-cpp Backend. Details in our guide.
Step 1: Verify Hardware & Install Dependencies
Section titled “Step 1: Verify Hardware & Install Dependencies”1.1. Check GPU Detection
lspci | grep -i nvidia
1.2. Install Required components
NVIDIA Driver:
nvidia-smi
CUDA Toolkit:
nvcc --version
Additional Requirements:
sudo apt updatesudo apt install gcc-11 g++-11 cpp-11export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/cuda/lib64
Step 2: Enable GPU Acceleration
Section titled “Step 2: Enable GPU Acceleration”Requires Vulkan support.
- Navigate to Settings > Hardware > GPUs
- Select appropriate backend in llama-cpp Backend. Details in our guide.
Requires Vulkan support.
- Navigate to Settings > Hardware > GPUs
- Select appropriate backend in llama-cpp Backend. Details in our guide.
Uninstall Jan
Section titled “Uninstall Jan”Removal commands:
sudo apt-get remove janrm -rf Janrm -rf ~/.config/Jan/datarm -rf ~/.config/Jan/cache
rm jan-linux-x86_64-{version}.AppImagerm -rf ~/.config/Jan