Set up Build Environment on macOS

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)"

Next, install the needed build tools:

brew install cmake asciidoctor

Install build dependencies

To install the actual build dependencies, there are two options:

1. Via Homebrew (faster, but suitable only for local builds).
2. Via vcpkg (much slower, but suitable for distribution builds).

Option 1: Install build dependencies via Homebrew

Open a terminal and run:

brew installqt@5 argon2 botan qrencode asciidoctor readline minizip

Option 2: Install build dependencies via vcpkg

Install vcpkg and pkg-config via Homebrew:

brew install vcpkg pkg-config

Next, update the vcpkg port files:

cd /opt/vcpkg && git pull

Finally, compile and install the actual build dependencies:

vcpkg install argon2 botan minizip qt5 qt5-svg qt5-tools qt5-imageformats \
    qt5-translations readline zlib libqrencode

Update your environment regularly

Homebrew:

brew update && brew upgrade

vcpkg:

cd /opt/vcpkg && git pull
vcpkg update