Energy Web Documentation
  • Energy Web Ecosystem
  • Launchpad by Energy Web
  • EWC Validator Documentation
  • Community Ressources
  • Legacy documentation
  • Start here
    • EWC Validator Documentation Overview
  • EWC Governance
    • Governance process
    • Proof-of-Authority Consensus Mechanism
    • EWC Validator Node Operational Functions
    • EWC Validator Roles & Responsibilities
    • Validators eligibility
    • Validators code of conduct
  • Guides
    • Set-up your Validator node in minutes with EW Launchpad
    • Installing a Validator Node
      • Host Machine Requirements
      • Recommended Security Settings
      • Operating System Requirements
      • Validator Node Installation Instructions
    • Maintaining a Validator Node
      • Validator Node Architecture
      • Validator Node Service Commands
      • Updating the Client
      • Changing the Validator Config File
      • Checking node status & logs
      • Migrating a validator node to a new environment
      • How To Transfer EWT from a Validator Node
      • Problems connecting to peers
  • Secure Your Validator Node
    • Changing validator payout address and setting up multi-signature
Powered by GitBook
On this page
Export as PDF
  1. Guides

Installing a Validator Node

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

PreviousSet-up your Validator node in minutes with EW LaunchpadNextHost Machine Requirements

Last updated 11 months ago

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

Find detailed instructions in our .

Be sure to follow the below steps in order!

Pre-Installation Checklist:

  1. Review the validator node , , and 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:

      • Additional information for Azure:

  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:

    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 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 to resolve.

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

  8. Read the to ensure you have a robust understanding of the inner workings:

    • Optional: Read the 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:

    • Join the #validator channel on Slack:

    • Join the #technical-discussions channel on Slack:

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

Launchpad by Energy Web
Quick Start Guide
Host Machine Requirements
Operating System Requirements
Recommended Security Settings
https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html
https://docs.microsoft.com/en-us/azure/virtual-network/virtual-network-ip-addresses-overview-arm
https://github.com/energywebfoundation/ewc-validator-node-install-scripts
EWC Validator Knowledge Base
Validator Knowledge Base
Validator Code of Conduct
documentation on the validator architecture
documentation on the system contracts
netops@energyweb.org
https://ewf-affiliates.slack.com/messages
https://ewf-affiliates.slack.com/messages
instructions for calling the setPayoutAddress function in the Reward Contract for further
here