Skip to content

Testing and Developing Nodes


Bootnodes are used to initially discover peers.

Mainnet and Public Testnets

For mainnet, Rinkeby, Ropsten, and Görli, Pantheon predefines a list of enode URLs.

Private Networks

To start a bootnode for a private network:

  1. Export the public key to a file:


    pantheon --genesis-file=privateNetworkGenesis.json --data-path=nodeDataPath public-key export --to=bootnode
    Where privateNetworkGenesis.json and nodeDataPath are changed to the relevant values for your private network.

    The node public key is exported to the bootnode file.

  2. Start the bootnode, specifying:

    • Genesis file and data directory as in the previous step.
    • No arguments for the --bootnodes option because this is your bootnode.


    pantheon --genesis-file=privateNetworkGenesis.json --data-path=nodeDataPath --bootnodes

To specify this bootnode for another node, the enode URL for the --bootnodes option is enode://<id>@<host:port> where:

  • <id> is the node public key written to the specified file (bootnode in the above example) excluding the initial 0x.
  • <host:port> is the host and port the bootnode is listening on for P2P peer discovery. Specified by the --p2p-host and --p2p-port options for the bootnode (default host is and port is 30303).


If the --p2p-host or --p2p-port options are not specified and the node public key exported is 0xc35c3ec90a8a51fd5703594c6303382f3ae6b2ecb9589bab2c04b3794f2bc3fc2631dabb0c08af795787a6c004d8f532230ae6e9925cbbefb0b28b79295d615f

The enode URL is: enode://c35c3ec90a8a51fd5703594c6303382f3ae6b2ecb9589bab2c04b3794f2bc3fc2[email protected]


The default host and port for P2P peer discovery is Use the --p2p-host and --p2p-port option to specify a host and port.

To start a node specifying the bootnode for P2P discovery:


pantheon --genesis-file=privateNetworkGenesis.json --data-path=nodeDataPath --p2p-host= --p2p-port=30301 --network-id=123 --bootnodes=enode://c35c3ec90a8a51fd5703594c6303382f3ae6b2ecb99bab2c04b3794f2bc3fc2[email protected]


Questions or feedback? You can discuss issues and obtain free support on Pegasys Pantheon Gitter room.
For paid professional support by PegaSys, contact us at [email protected]