Skip to content

Latest commit

 

History

History
39 lines (29 loc) · 3.09 KB

node-sync-private.md

File metadata and controls

39 lines (29 loc) · 3.09 KB
sidebar_label sidebar_position description tags
Node synchronization
4
Learn about node synchronization for private networks.
private networks

Node synchronization for private networks

For private, permissioned blockchain networks, Besu uses the same synchronization modes as public networks, but with specific configurations for private network needs.

To sync Besu on a private network:

  • Ensure all nodes use compatible sync modes and configurations.
  • Configure the network with a custom genesis file.
  • Set the network ID and bootnodes specific to your private network.
  • Implement permissioning features to control network access.

The following is an overview of the private network sync modes. Select the sync mode based on your network's requirements and node purposes.

Sync mode Description Requirements Limitations
Snap Recommended for fastest sync and lowest storage requirements on Mainnet. Downloads as many leaves of the trie as possible and reconstructs the trie locally. Faster than fast sync. Besu version 24.3.0 or later Cannot switch from fast sync to snap sync mid-process.
Checkpoint Syncs from a specific checkpoint block configured in the genesis file. Fastest sync mode with lowest storage requirements. Besu version 22.4.3 or later Not supported for QBFT or IBFT 2.0 networks without a checkpoint configuration.
Fast Downloads block headers and transaction receipts, verifies chain from genesis block. None Deprecated. Not supported with private transactions.
Full Default for all private networks. Downloads and verifies the entire blockchain and state from genesis block, building an archive node with full state history. None Slowest sync mode, requires the most disk space.

:::warning Early access feature

--Xsnapsync-bft-enabled is an early access feature available in Besu version 24.7.1 and later. It is not stable, so use this option with caution.

Use --Xsnapsync-bft-enabled with --sync-mode=SNAP to enable snap sync in QBFT and IBFT 2.0 private networks.

:::