Installation

Pre-built blvm binaries, Linux packages, Windows builds, and Docker images are published on GitHub Releases. The book does not pin release numbers: use the install page for the current tag, filenames, and checksum commands.

Install (downloads + verify): btcdecoded.org/install

Always verify checksums.sha256 (or the release checksum file) before running a downloaded artifact.

Platform matrix

Artifact	Platform	Feature set	Typical use
Release tarball / package	Linux x86_64	Full defaults (`rest-api`, `bip70-http`, `compression`, `governance`, `iroh`, `dandelion`, `utxo-commitments`, …)	Production mainnet / testnet
Release tarball / package	Linux aarch64, Windows x86_64	Portable subset (`sled`, `redb`, `production`, `protocol-verification`, `utxo-commitments`; no REST / BIP70 HTTP / compression)	Lighter deployments
Docker	GHCR ghcr.io/btcdecoded/blvm	Per-release tag	Container ops
Source build	Any supported Rust target	Explicit `--features`	Experimental flags, custom arch

Details: Release process: Build variants.

Local cargo build in the blvm repo uses default features unless you pass --no-default-features or explicit --features.

Experimental build variant

Stable GitHub Releases ship the base binary set per tag (platform-specific features: see Release process: Build variants). Extra compile-time features: BIP119 CTV, Stratum V2 node demux, sigop counting, Quinn transport, and flags not in your platform artifact: require a source build with explicit --features.

Build from source

For other architectures, experimental compile-time features, or development: blvm on GitHub and Release process.

Managed installs (not ready yet)

Umbrel App Store: coming soon. Use btcdecoded.org/install, Docker on GHCR, or build from source until managed marketplace listings ship.

Who is this for?

Operators: Quick Start (regtest) → First Node Setup (config + mainnet IBD)
Module developers: Building your first module
Researchers: Introduction

BLVM Documentation