Documentation
Install 👋 Jan
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
    • Kubuntu
    • Lubuntu
    • Ubuntu Budgie
    • Ubuntu Cinnamon
    • Ubuntu Kylin
    • Ubuntu MATE
    • Linux Mint
    • Pop!_OS

RHEL-based (Supports .rpm and AppImage)

  • RHEL-based (Server only)
  • Fedora

Arch-based

  • Arch Linux
  • SteamOS

Independent

  • openSUSE

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 the NVIDIA Driver (opens in a new tab), ideally via your package manager.
  2. Verify:

nvidia-smi

CUDA Toolkit:

  1. Install the CUDA toolkit (opens in a new tab), ideally from your package manager (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.

WindowsBETA apps