Skip to content
You are reading Hyperledger Besu development version documentation and some displayed features may not be available in the stable release. You can switch to stable version using the version box at screen bottom.
Last update: September 2, 2021

Updating nodes and accounts allowlists

Update nodes allowlist

To add a node to the Hyperledger Besu nodes allowlist:

  1. On the Nodes tab of the permissioning management dapp, click the Add Node button. The Add Node window displays.
  2. Enter the enode URL of the node you are adding and click the Add Node button.

To remove a node from the nodes allowlist:

  1. On the Nodes tab of the permissioning management dapp, hover over the row of the node you are removing. A trash can displays.
  2. Click on the trash can.

Tip

If you add a running node, the node does not attempt to reconnect to the bootnode and synchronize until peer discovery restarts. To add an allowlisted node as a peer without waiting for peer discovery to restart, use admin_addPeer.

If you add the node to the allowlist before starting the node, using admin_addPeer is not required because peer discovery is run on node startup.

Tip

If nodes are not connecting as expected, set the log level to TRACE and search for messages containing Node permissioning to identify the issue.

Ensure the --p2p-host command line option has been correctly configured for all nodes with the externally accessible address.

Update accounts allowlist

To add an account to the accounts allowlist:

  1. On the Accounts tab of the permissioning management dapp, click the Add Account button. The add Account Window displays.
  2. Enter the account address in the Account Address field and click the Add Account button.

To remove an account from the accounts allowlist:

  1. On the Accounts tab of the permissioning management dapp, hover over the row of the account you are removing. A trash can displays.
  2. Click on the trash can.

Update admins

You can add or remove Admins in the same way as accounts, except on the Admins tab.

Questions or feedback? You can discuss issues and obtain free support on Hyperledger Besu chat channel.
For Hyperledger Besu community support, contact the mailing list besu@lists.hyperledger.org