Set up Build Environment on OS X

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

Install the build environment

Install Homebrew (it is the easiest way to install the required packages on macOS):

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Install the C++ toolchain

This command will install Cmake

Open a Terminal

brew install cmake

Install the required dependencies

Then install the required libraries (zlib already exists on macOS Sierra so it is not needed to install it):

Open a Terminal:

brew install qt5 libgcrypt argon2 libyubikey ykpers qrencode libsodium wget

For OnlyKey and Yubikey support:

wget https://github.com/trustcrypto/yubikey-personalization/releases/download/v1.19.1/ykpers-1.19.1.tar.gz
tar xf ykpers-1.19.1.tar.gz
cd ykpers-1.19.1
autoreconf --install
./configure
make check install

Update your environment regularly

Open a Terminal:

brew update && brew upgrade