Skip to content

bootnode CLI Command


Run a discv5 bootnode. This will NOT perform any beacon node functions, rather, it will run a discv5 service that allows nodes on the network to discover one another.


bootnode Options

--dataDir

description: Lodestar root data directory

type: string


--network

description: Name of the Ethereum Consensus chain network to join

type: string

choices: "mainnet", "gnosis", "goerli", "ropsten", "sepolia", "holesky", "chiado", "ephemery", "dev"

default: "mainnet"


--paramsFile

description: Network configuration file

type: string


--terminal-total-difficulty-override

description: Terminal PoW block TTD override

type: string


--terminal-block-hash-override

description: Terminal PoW block hash override

type: string


--terminal-block-hash-epoch-override

description: Terminal PoW block hash override activation epoch

type: string


--listenAddress

description: The IPv4 address to listen for discv5 connections

type: string

default: "0.0.0.0"


--port

description: The UDP port to listen on

type: number

default: 9000


--listenAddress6

description: The IPv6 address to listen for discv5 connections

type: string


--port6

description: The UDP port to listen on

type: number

default: 9090


--bootnodes

description: Additional bootnodes for discv5 discovery

type: string[]

default: [ "[]" ]


--bootnodesFile

description: Additional bootnodes for discv5 discovery file path

type: string


--persistNetworkIdentity

description: Whether to reuse the same peer-id across restarts

type: boolean

default: true


--enr.ip

description: Override ENR IP entry

type: string


--enr.udp

description: Override ENR UDP entry

type: number


--enr.ip6

description: Override ENR IPv6 entry

type: string


--enr.udp6

description: Override ENR (IPv6-specific) UDP entry

type: number


--nat

description: Allow ENR configuration of non-local addresses

type: boolean


--logLevel

description: Logging verbosity level for emitting logs to terminal

type: string

choices: "error", "warn", "info", "verbose", "debug", "trace"

default: "info"


--logFile

description: Path to output all logs to a persistent log file, use 'none' to disable

type: string


--logFileLevel

description: Logging verbosity level for emitting logs to file

type: string

choices: "error", "warn", "info", "verbose", "debug", "trace"

default: "debug"


--logFileDailyRotate

description: Daily rotate log files, set to an integer to limit the file count, set to 0 (zero) to disable rotation

type: number

default: 5


--metrics

description: Enable the Prometheus metrics HTTP server

type: boolean


--metrics.port

description: Listen TCP port for the Prometheus metrics HTTP server

type: number

default: 8008


--metrics.address

description: Listen address for the Prometheus metrics HTTP server

type: string

default: "127.0.0.1"