Get started
Bitcoin Roots connects to the Bitcoin peer-to-peer network to download and fully validate blocks and transactions. It also includes a wallet and graphical user interface, which can be optionally built.
Choose the guide for the system where you plan to run your node:
This source tree tracks the Core v32.1 port and v32.1-roots.1 source. Read the 32.x port review and current build requirements before building. Source availability does not establish release publication. Published downloads and patches are listed in the release patch browser, which excludes unpublished drafts. Use that catalogue to check which versions have public assets.
- Linux and other Unix-like systems
- macOS
- Windows
- Windows with Microsoft Visual Studio
- FreeBSD
- OpenBSD
- NetBSD
Before you run
Read the configuration reference before changing defaults. For a smaller home-node footprint, the existing guides cover reducing memory usage and reducing traffic.
Bitcoin Roots follows Bitcoin Core-compatible consensus while maintaining conservative, configurable transaction relay and mempool policy. It does not enforce RDTS/BIP-110 consensus rules. Read the transaction relay policy documentation for the boundary between local policy and block validity.
Go deeper
The documentation atlas indexes every Markdown guide shipped in this repository, including operations, architecture, wallet, API, testing, release, and embedded-library references.