Operator guide

How-to hub for running a BLVM node. You do not need the Consensus, Protocol, or Governance sections for day-to-day operations.

New to BLVM? InstallationQuick Start (regtest, ~5 minutes) → this page for ongoing tasks.

First sync and daily run

TaskGuide
Config, RPC verify, and mainnet IBDFirst Node Setup (mainnet IBD)
Regtest local dev (5 min)Quick Start
Start / stop / backupNode Operations
Import Bitcoin Core datadirOperations — Core datadir
Configuration file and envNode configuration
All config keys (reference)Configuration Reference

Initial block download (IBD)

Mainnet first sync touches several docs—use this map instead of reading them in arbitrary order.

TopicGuide
First mainnet sync (config, RPC verify, checklist)First Node Setup — Mainnet IBD
Parallel download, chunk tuning, assume-validPerformance — Parallel IBD
Optional age-tiered UTXO store (BLVM_IBD_ENGINE=1)IBD UTXO engine
Bandwidth limits when serving peers during their IBDIBD bandwidth protection
Stuck, slow, or quiet syncTroubleshooting — Mainnet IBD
[ibd] keys and BLVM_IBD_* env varsConfiguration Reference — IBD

Security before mainnet

TaskGuide
Pre-mainnet checklistDeployment posture
RPC auth and transportRPC transport × authentication
Threat surfacesThreat models

RPC and monitoring

TaskGuide
JSON-RPC methods and parityRPC API Reference
Error codesJSON-RPC error reference
Health / metrics / logsOperations — Monitoring

Storage and network

TaskGuide
Database backendsStorage Backends
LAN peering (faster sync when LAN peers exist)LAN Peering
Transports (TCP default)Transport abstraction
Mempool / RBF policiesRBF and Mempool Policies

Mining (optional)

TaskGuide
Mining overviewMining Integration
Stratum V2Stratum V2 + Merge Mining, Stratum V2 module
DATUM / OceanDatum module

Optional modules

ModulePage
Full catalogModule catalog
ZMQ notificationsZMQ module
FIBRE block relayFIBRE module
Mesh paymentsMesh module

Examples and troubleshooting

When you need deeper context