Windows builds use Visual Studio 2026 (MSVC toolset v145). CI builds and tests the static debug and release configurations on x64.
1. Prerequisites#
- Visual Studio 2026 with the Desktop development with C++ workload. The Community edition is sufficient.
- Git.
- nuget.exe, from nuget.org, on
the
PATH.
Build from a Developer Command Prompt for VS 2026, which puts
msbuild on the PATH.
2. Build with the script#
Clone the five repositories side by side:
$ mkdir libbitcoin
$ cd libbitcoin
$ git clone https://github.com/libbitcoin/libbitcoin-system
$ git clone https://github.com/libbitcoin/libbitcoin-database
$ git clone https://github.com/libbitcoin/libbitcoin-network
$ git clone https://github.com/libbitcoin/libbitcoin-node
$ git clone https://github.com/libbitcoin/libbitcoin-server
Then build all five:
$ cd libbitcoin-server
$ builds\msvc\build-msvc.cmd --build-src-dir .. --build-config StaticRelease --build-platform x64 --build-use-local-src
The script restores the NuGet packages, including Boost, and builds
libbitcoin-system, libbitcoin-database, libbitcoin-network,
libbitcoin-node and libbitcoin-server in order, then runs the tests. The
result is bin\x64\Release\v145\static\bs.exe.
| Option | Values |
|---|---|
--build-config |
StaticRelease or StaticDebug (required) |
--build-platform |
x64 (default), ARM64 or Win32 |
--build-skip-tests |
Do not build or run the tests |
--build-symbols |
default, disabled or public-only |
Other arguments are passed to msbuild. Build options are set as
properties, for example /p:Option-cuda=false (see
Build options).
3. Build in Visual Studio#
Open builds\msvc\vs2026\libbitcoin-server.sln. It contains
libbitcoin-server, its tests and bs, and references the other four
libraries in their sibling directories. Select StaticRelease or
StaticDebug and build. NuGet packages are restored on the first build.
Build options are on each project's property pages, under Configuration Properties.
4. Instruction set#
Windows x64 and Win32 builds target AVX2 by default, so bs.exe
requires a CPU with AVX2 (Intel Haswell, AMD Excavator or later).