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: December 13, 2021

Updating nodes and accounts allowlists

When using onchain permissioning, you can update 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, select Add Node. The Add Node window displays.
  2. Enter the enode URL of the node you are adding and select Add Node.

Important

Node allowlists support domain names in enode URLs as an experimental feature. Use the --Xdns-enabled option to enable domain name support.

If using Kubernetes, enable domain name support and use the --Xdns-update-enabled option to ensure that Besu can connect to a container after being restarted, even if the IP address of the container changes.

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. Select 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, select Add Account. The Add Account window displays.
  2. Enter the account address in the Account Address field and select Add Account.

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. Select 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