50

Set up Build Environment on Linux

Jonathan White edited this page 2025-10-02 18:32:45 -04:00

Table of Contents

• Install the build toolchain
• Install the required dependencies
• Update your environment regularly

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 g++ 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

or

sudo pacman -S cmake make gcc-multilib asciidoctor

Install the required dependencies

On Debian/Ubuntu:

sudo apt install qtbase5-dev qtbase5-private-dev qttools5-dev qttools5-dev-tools \
    libqt5svg5-dev libargon2-dev libminizip-dev libbotan-2-dev libqrencode-dev \
    libkeyutils-dev zlib1g-dev libreadline-dev libpcsclite-dev libusb-1.0-0-dev \
    libxi-dev libxtst-dev  libqt5x11extras5-dev

Ubuntu 18.04 and below replace libargon2-dev with libargon2-0-dev

On Fedora/RHEL/CentOS:

sudo dnf install qt5-qtbase-devel qt5-qtbase-private-devel qt5-linguist qt5-qttools \
    qt5-qtsvg-devel libargon2-devel qrencode-devel botan2-devel readline-devel \
    keyutils-libs-devel zlib-devel pcsc-lite-devel libusb1-devel libXi-devel \
    libXtst-devel qt5-qtx11extras-devel minizip-compat-devel

CentOS requires more up-to-date packages, provided here: https://copr.fedorainfracloud.org/coprs/bugzy/keepassxc/

On Arch Linux:

sudo pacman -S qt5-base qt5-tools qt5-svg argon2 botan qrencode zlib readline \
    keyutils pcsclite libusb libxi libxtst qt5-x11extras minizip

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

Copyright (C) 2016-2025 KeePassXC Team