build2 | Installation

The recommended way to install or upgrade build2 is using the automated install scripts. Download a version for your platform (see below), verify its checksum, run, and follow the onscreen instructions. The script will prompt for your confirmation before building or installing anything. See the Installation FAQ for common installation questions and Other Installation Methods for alternatives (binary packages, etc).

To build and install build2 all you will need is a reasonably recent C++ compiler. See Which compilers are supported? for details.

You will normally want to keep the build directory around for upgrades or to cleanly uninstall the toolchain. An automated upgrade can be performed from any previous patch release and from the most recent previous minor version.

1UNIX (Linux, Mac OS, FreeBSD)
2Windows with MSVC
3Windows with Clang
4Windows with MinGW
5Other Installation Methods

1 UNIX (Linux, Mac OS, FreeBSD)

Create the build2 build directory, for example ~/build2-build in your home directory, then run:

$ cd ~/build2-build

$ curl -sSfO https://download.build2.org/0.13.0/build2-install-0.13.0.sh

$ shasum -a 256 -b build2-install-0.13.0.sh

  aeec2ac0e7080341159bbbc95d8264521ddf82bda01c5c253d63cae5b4558b15

$ sh build2-install-0.13.0.sh

Or, to upgrade from 0.12.0:

$ sh build2-install-0.13.0.sh --upgrade

To uninstall:

$ sh build2-install-0.13.0.sh --uninstall

See the Installation FAQ for common platform-specific issues and solutions.

2 Windows with MSVC

Create the build2 build directory, for example, C:\build2-build, download build2-install-msvc-0.13.0.bat into it, start the Visual Studio x64 Command Prompt, then run:

> cd C:\build2-build

> certutil -hashfile build2-install-msvc-0.13.0.bat SHA256

  bb20552ef26862ee9101c9e5f1677ddae911798bafc259b1ef06f64ba29ab163

> build2-install-msvc-0.13.0.bat

Or, to upgrade from 0.12.0:

> build2-install-msvc-0.13.0.bat --upgrade

Note that currently the automated upgrade process does not upgrade the baseutils package. Use the from-scratch installation if you would like to upgrade this package.

To uninstall:

$ build2-install-msvc-0.13.0.bat --uninstall

See the Installation FAQ for common Windows-specific issues and solutions.

3 Windows with Clang

There are two common ways to obtain Clang targeting the MSVC runtime: bundled with the MSVC installation (by selecting the Clang tools component in the Visual Studio installer) or as a separate installation (by getting the installer from the LLVM Download page).

If you are using a separate installation, then the Clang compiler is most likely already in your PATH environment variable and you don't have to use the Visual Studio command prompt below.

Create the build2 build directory, for example, C:\build2-build, download build2-install-clang-0.13.0.bat into it, start the Visual Studio x64 Command Prompt, then run:

> cd C:\build2-build

> certutil -hashfile build2-install-clang-0.13.0.bat SHA256

  a8c08441c82b9601e61634933fa1bfe1ef08f0d4e22e51b34d50a33ad81f0163

> build2-install-clang-0.13.0.bat

Or, to upgrade from 0.12.0:

> build2-install-clang-0.13.0.bat --upgrade

Note that currently the automated upgrade process does not upgrade the baseutils package. Use the from-scratch installation if you would like to upgrade this package.

To uninstall:

$ build2-install-clang-0.13.0.bat --uninstall

See the Installation FAQ for common Windows-specific issues and solutions.

4 Windows with MinGW

Create the build2 build directory, for example, C:\build2-build, download build2-install-mingw-0.13.0.bat into it, start the Command Prompt, then run:

> cd C:\build2-build

> certutil -hashfile build2-install-mingw-0.13.0.bat SHA256

  60f36c7f5135676d0772dd67ccfac012b8bcb9e9177c9305a889fd54782b6870

> build2-install-mingw-0.13.0.bat

The build2-install-mingw script downloads and installs (into the same directory as build2) a minimal MinGW GCC distribution that is then used to compile build2. If you would prefer to use your own MinGW GCC, see the alternative installation methods below.

Or, to upgrade from 0.12.0:

> build2-install-mingw-0.13.0.bat --upgrade

Note that currently the automated upgrade process does not upgrade the baseutils and mingw packages. Use the from-scratch installation if you would like to upgrade these packages.

To uninstall:

$ build2-install-mingw-0.13.0.bat --uninstall

See the Installation FAQ for common Windows-specific issues and solutions.

5 Other Installation Methods

The steps described above are the preferred way to install build2 for most developers. For alternative from-source installation methods that offer more control see the Installation and Upgrade manual. To manually obtain various components of the build2 toolchain refer to the Download page.

The build2 binary packages are also starting to appear in the official package repositories of some Linux distributions, see: Fedora, Gentoo, and Arch Linux.

There are also third-party binary packages for Debian, Ubuntu, CentOS/RedHat, and Fedora. Note, however, that they are not tested as part of the official build2 release process and are not guaranteed to be available in the future.