Installing a Validator Node

This page provides an overview of the steps required to install a validator node on the Energy Web Chain.

Note: Validators who opt to install and run their nodes externally can use Launchpad by Energy Web to install and host their Validator Nodes.

Find detailed instructions in our Quick Start Guide.

Be sure to follow the below steps in order!

Pre-Installation Checklist:

1. Review the validator node Host Machine Requirements, Operating System Requirements, and Recommended Security Settings carefully. Then choose a host environment (on-premise hardware or qualified cloud provider) and favored operating system.

2. Assign a static public IP address to the host.

   • Make sure that the public IP will not change over time.

     • Additional information for AWS: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html

     • Additional information for Azure: https://docs.microsoft.com/en-us/azure/virtual-network/virtual-network-ip-addresses-overview-arm

3. Verify that the host is dedicated only for the EW Chain Validator client.

   • If yes, proceed to the next step.

   • If no, remove all other processes / applications from the host, or create a new isolated instance.

4. Verify that you have the correct installation script for your chosen OS here: https://github.com/energywebfoundation/ewc-validator-node-install-scripts

   1. If yes, then proceed to the next step.

   2. If no, choose the correct installation script before proceeding.

5. Review the default safe firewall settings set up by the installation script.

   1. Do these settings comply with your company's firewall settings or will you have to adapt them afterwards?

      1. If the default settings comply with your company’s policies, proceed to the next step.

      2. If the default settings do not comply with your company’s policies, adapt the settings as necessary. If you encounter issues or conflicts with internal IT policies, you can post in the EWC Validator Knowledge Base to discuss resolution options.

6. Review the installation script and verify that there are no errors or discrepancies with your system setup (link above).

   1. If errors are observed, open an Issue in the installation script Github repository or post to ta relevant topic in the Validator Knowledge Base to resolve.

7. Make sure you have read and understand the operational and governance rules and responsibilities as outlined in the Validator Code of Conduct.

8. Read the documentation on the validator architecture to ensure you have a robust understanding of the inner workings:

   • Optional: Read the documentation on the system contracts to familiarize yourself with the overall system.

9. Confirm that you have at least two ways to contact EWF and the valdiator community if you encounter problems:

   • NetOps distribution list: [e-mail]

   • Join the #validator channel on Slack: https://ewf-affiliates.slack.com/messages

   • Join the #technical-discussions channel on Slack: https://ewf-affiliates.slack.com/messages

10. Ensure that you are prepared to receive and securely handle value-bearing Energy Web Tokens (“EWT”) from block rewards at the time your validator is added to the validator set.

    • EWF strongly recommends that your organization implements a robust internal governance process and security policy for managing the validator node private keys, accessing the node, and managing its EWT balance.

    • If you would like to hold block rewards in an address separate from the validator node, you can change the block reward payout address. Please see instructions for calling the setPayoutAddress function in the Reward Contract for further details. Please note that it is not possible to reallocate transaction fees to a separate account, so all validator nodes will accrue and maintain a balance of EWT from transaction fees.

11. Once all of the above steps are completed, install your validator node following the instructions here.