59
Set up Build Environment on Linux
Janek Bevendorff edited this page 2026-11-01 12:14:59 +01:00

Note: This is only a one-time setup guide. For actually building KeePassXC, please refer to our build guide.

Install the build toolchain

You can skip this step if you have a working C++ toolchain (g++, cmake and make)

On Debian/Ubuntu:

sudo apt install build-essential cmake asciidoctor

On Fedora/RHEL/CentOS:

sudo dnf install make automake gcc-c++ cmake rubygem-asciidoctor 

On Arch Linux:

sudo pacman -S cmake make gcc asciidoctor

Install the required dependencies

On Debian/Ubuntu:

sudo apt install libbotan-3-dev libkeyutils-dev libminizip-dev libpcsclite-dev libqrencode-dev \
    libreadline-dev libusb-1.0-0-dev libxkbcommon-dev libxtst-dev qt6-tools-dev \
    qt6-l10n-tools qt6-svg-dev zlib1g-dev

On Ubuntu 22.04 LTS (Jammy), make sure these are installed:

sudo apt install libbotan-2-dev libkeyutils-dev libminizip-dev libpcsclite-dev libqrencode-dev \
    libqt6svg6-dev libreadline-dev libusb-1.0-0-dev libxkbcommon-dev libxtst-dev qt6-tools-dev \
    qt6-tools-dev-tools qt6-l10n-tools zlib1g-dev

On Fedora/RHEL/CentOS:

sudo dnf install botan3-devel keyutils-libs-devel minizip-compat-devel qrencode-devel \
    readline-devel libusb1-devel pcsc-lite-devel libXtst-devel t6-qttools-devel qt6-qtsvg-devel

On Arch Linux:

sudo pacman -S --needed botan qrencode readline pcsclite libusb libxtst minizip qt6-tools qt6-svg

Update your environment regularly

On Debian/Ubuntu:

sudo apt-get update && sudo apt-get upgrade

On Fedora/RHEL/CentOS:

sudo dnf update && sudo dnf upgrade

On Arch Linux:

sudo pacman -Syyuu