`build2` | Installation

The easiest way to install build2 is using binary packages, as described below. An alternative is to build it from source either using the automated install scripts or manually. For additional ways to obtain both binary and source packages, refer to the Download page or GitHub Releases.

The build2 project provides "official" binary packages for many mainstream operating systems. Plus, for some operating systems, binary packages may be available from their official or community package repositories. In particular, build2 is available from Homebrew, FreeBSD ports, and WinGet.

Official binary packages of development snapshots are also available.

1	Debian and Ubuntu
2	Fedora and RHEL
3	Generic Linux
4	Windows
5	Mac OS
6	FreeBSD

1 Debian and Ubuntu

Debian download
Ubuntu download

apt-get install ./build2-toolchain_0.18.1-0~debian13_amd64.deb
apt-get install ./build2-toolchain_0.18.1-0~ubuntu24.04_amd64.deb

Note that the .deb files must include a directory separator (/) in order for apt to recognize them as files rather than as package names.

2 Fedora and RHEL

Fedora download
RHEL download

dnf install build2-toolchain-0.18.1-1.fc43.x86_64.rpm
dnf install build2-toolchain-0.18.1-1.el9.x86_64.rpm

3 Generic Linux

Generic Linux download

The binaries in the Generic Linux package can be used on any Linux distribution with glibc version 2.31 or later and libstdc++ from GCC 10 or later.

The binaries are relocatable and can be installed anywhere, for example, to install to /usr/local/:

tar -xf build2-toolchain-0.18.1-x86_64-linux-glibc2.31-gcc10.tar.xz \
  -C /usr/local --strip-components=1

4 Windows

Windows download

The Windows binaries are relocatable and can be installed anywhere.

For example, using the MSVC runtime (recommended):

md C:\build2
tar -xf build2-toolchain-0.18.1-x86_64-windows10-msvc17.zip ^
  -C C:\build2 --strip-components=1

You can also install this package using WinGet:

winget install --id build2.build2.MSVC

Or using MinGW (includes a minimal MinGW GCC distribution):

md C:\build2
tar -xf build2-toolchain-0.18.1-x86_64-windows10-mingw-gcc14.zip ^
  -C C:\build2 --strip-components=1

You can also install this package using WinGet:

winget install --id build2.build2.MinGW

5 Mac OS

Install from Homebrew:

brew install build2

6 FreeBSD

Install from ports:

pkg install build2

build2 | Installation