Bootstrap

A full node must perform one-time initialization by bootstrapping its local chain state to the target network's genesis block.

Native binary

For an official network:

miden-node bootstrap \
  --data-directory full-node-data \
  --network <network>

For a local or custom network:

miden-node bootstrap \
  --data-directory full-node-data \
  --file genesis.dat

The data directory must be empty when bootstrapping.

Docker image

For an official network:

docker run --rm \
  -v miden-full-node-data:/data \
  ghcr.io/0xmiden/miden-node:<release-tag> \
  miden-node bootstrap \
  --data-directory /data \
  --network <network>

For a local or custom network:

docker run --rm \
  -v miden-full-node-data:/data \
  -v "$PWD/genesis.dat:/genesis.dat:ro" \
  ghcr.io/0xmiden/miden-node:<release-tag> \
  miden-node bootstrap \
  --data-directory /data \
  --file /genesis.dat

The data volume must be empty when bootstrapping.

Use the same node version and genesis source as the upstream network you intend to follow.