Documentation
Linux

Linux Installation

Instructions for installing Jan on Linux.

Compatibility

System requirements:

Debian-based (Supports .deb and AppImage)

  • Debian
  • Ubuntu and derivatives:
    • Ubuntu Desktop LTS (official)/Ubuntu Server LTS (only for server)
    • Edubuntu (Mainly desktop)
    • Kubuntu (Desktop only)
    • Lubuntu (Both desktop and server, though mainly desktop)
    • Ubuntu Budgie (Mainly desktop)
    • Ubuntu Cinnamon (Desktop only)
    • Ubuntu Kylin (Both desktop and server)
    • Ubuntu MATE (Desktop only)

RHEL-based (Supports .rpm and AppImage)

  • RHEL-based (Server only)
  • Fedora

Arch-based

  • Arch Linux (Mainly desktop)
  • SteamOS (Desktop only)

Independent

  • openSUSE (Both desktop and server)

Desktop or server support varies by distribution.

Install Jan

Installation steps:

Step 1: Download Application

Available releases:

Step 2: Install Application

Installation commands:

dpkg

sudo dpkg -i jan-linux-amd64-{version}.deb

apt-get

sudo apt-get install ./jan-linux-amd64-{version}.deb

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

Configuration for GPU support:

Step 1: Verify Hardware & Install Dependencies

1.1. Check GPU Detection


lspci | grep -i nvidia

1.2. Install Required components

NVIDIA Driver:

  1. Install NVIDIA Driver (opens in a new tab) (version 470.63.01+)
  2. Verify:

nvidia-smi

CUDA Toolkit:

  1. Install CUDA toolkit (opens in a new tab) (11.7+)
  2. Verify:

nvcc --version

Additional Requirements:


sudo apt update
sudo apt install gcc-11 g++-11 cpp-11
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/cuda/lib64

Documentation (opens in a new tab)

Step 2: Enable GPU Acceleration

  1. Navigate to Settings () > Local Engine > Llama.cpp
  2. Select appropriate backend in llama-cpp Backend. Details in our guide.

CUDA offers better performance than Vulkan.

Uninstall Jan

Removal commands:


sudo apt-get remove jan
rm -rf Jan
rm -rf ~/.config/Jan/data
rm -rf ~/.config/Jan/cache

⚠️

These commands permanently delete application data.