Skip to main content

Run a New Boot Node

Prepare and Run

To run a new boot node (refer to this page for node types) the specific command-line arguments you should set are the following:

NameDescriptionValue
--listen-addrListen on this multiaddress.
By default: If --validator is passed: /ip4/0.0.0.0/tcp/<port> and /ip6/[::]/tcp/<port>. Otherwise: /ip4/0.0.0.0/tcp/<port>/ws and /ip6/[::]/tcp/<port>/ws.
Multiaddress matching the p2p and p2p/ws ports your machine externally exposes.
--node-key-fileFile from which to read the node's secret key to use for p2p networking.
The contents of the file are parsed according to the choice of --node-key-type as follows:
- ed25519: the file must contain an unencoded 32 byte or hex encoded Ed25519 secret key.
If the file does not exist, it is created with a newly generated secret key of the chosen type.
Absolute or relative path.

The node-key file can be generated and inspected with nh-node command key, subcommands generate-node-key and inspect-node-key (refer to this section for further details).

You can then start with:

target/production/nh-node --name MyZkVerifyBootNode --base-path /home/your_user/boot_node_data --chain test --port 30333 --listen-addr /ip4/0.0.0.0/tcp/30333 --listen-addr /ip4/0.0.0.0/tcp/30334/ws
note

You can change the values of the above args based on your needs.

You can check from the logs printed out in the console that your boot node is up and running (e.g. it keeps updating the chain tip, it is connected to other peers, etc.).

Refer to this section for the next steps you need to take after starting your boot node.