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}.debapt-get
Section titled āapt-getāsudo apt-get install ./jan-linux-amd64-{version}.debFrom the terminal, run the following commands:
chmod +x jan-linux-x86_64-{version}.AppImage./jan-linux-x86_64-{version}.AppImageData Folder
Section titled āData FolderāDefault locations:
# Custom installation directory$XDG_CONFIG_HOME = /home/username/custom_config
# or
# Default installation directory~/.config/Jan/dataSee Jan Data Folder for details.
GPU Acceleration
Section titled āGPU AccelerationāConfiguration for GPU support:
Step 1: Verify Hardware & Install Dependencies
Section titled āStep 1: Verify Hardware & Install Dependenciesā1.1. Check GPU Detection
lspci | grep -i nvidia1.2. Install Required components
NVIDIA Driver:
- Install the NVIDIA Driver, ideally via your package manager.
- Verify:
nvidia-smiCUDA Toolkit:
- Install the CUDA toolkit, ideally from your package manager (11.7+)
- Verify:
nvcc --versionAdditional Requirements:
sudo apt updatesudo apt install gcc-11 g++-11 cpp-11export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/cuda/lib64Step 2: Enable GPU Acceleration
Section titled āStep 2: Enable GPU Accelerationā- Navigate to Settings > Local Engine > Llama.cpp
- 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.
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/cacherm jan-linux-x86_64-{version}.AppImagerm -rf ~/.config/Jan