BLVM Node

Main binary for the Bitcoin Commons BLVM full node — the blvm executable wrapping the blvm-node library.

Operator guides live in docs.thebitcoincommons.org. This README is a repo landing page only.

Install

Downloads, current release tag, filenames, and checksum commands: btcdecoded.org/install

Also: GitHub Releases (latest) · Installation (book)

Always verify the checksum file shipped with the artifact you downloaded (checksums.sha256, SHA256SUMS-*, or per-file .sha256 — names vary by release).

Stable release artifacts

Format	Linux x86_64	Linux aarch64	Windows x86_64
.deb (Debian/Ubuntu)	yes	—	—
.rpm (Fedora/RHEL)	yes	—	—
.pkg.tar.gz (Arch)	yes	—	—
.tar.gz archive	yes	yes	—
Standalone binary	yes	yes	—
Portable .exe / .zip	—	—	yes

Docker (stable): ghcr.io/btcdecoded/blvm — tag matches the GitHub Release (see install page).

Nightly (rolling): develop branch → GitHub nightly assets and ghcr.io/btcdecoded/blvm:nightly. See Release channels.

Source: clone this repo; toolchain in rust-toolchain.toml. Feature sets differ by platform — build variants.

Release tarballs also ship helper scripts and example configs (e.g. blvm-mainnet-ibd.toml.example, scripts/start-ibd-mainnet.sh).

Documentation map

Topic	Link
Regtest tutorial	Quick Start
Config & RPC ports	First Node Setup
Mainnet IBD	Mainnet initial sync
Configuration	Node configuration · CONFIGURATION.md · blvm.toml.example
Storage backends	Storage Backends
RPC	RPC API Reference
IBD tuning	IBD configuration · IBD engine
Troubleshooting	Troubleshooting
Contributing	Contributing

Quick start (regtest)

After install:

blvm version
blvm --network regtest --verbose

Guided walkthrough: Quick Start.

Mainnet first sync: use the IBD example config — not bare --network mainnet. Mainnet initial sync.

Common commands

blvm status
blvm health
blvm sync          # same --network / --config / --data-dir as the running node
blvm rpc getblockchaininfo
blvm config show

RPC defaults: mainnet 8332, testnet 18332, regtest 18443. Details: RPC API.

Build from source

git clone https://github.com/BTCDecoded/blvm.git
cd blvm
cargo build --release --locked

Optional backends and experimental flags: explicit --features — Installation — experimental variant.

RocksDB (when using blvm-mainnet-ibd.toml.example):

cargo build --release --locked --features rocksdb

Architecture

blvm (binary)
  └── blvm-node
       └── blvm-protocol
            └── blvm-consensus

Stack overview

License

MIT