Step 5: Installing consensus client
Pick a consensus client
Your choice of Lighthouse, Nimbus, Teku, Prysm or Lodestar.
Reminder: Ensure you are logged in and execute all steps in this guide as non-root user, ethereum ,created during Step 2: Configuring Node.
⚙️ 5.1. Install rust dependency
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | shEnter '1' to proceed with the default install.
Update your environment variables.
echo export PATH="$HOME/.cargo/bin:$PATH" >> ~/.bashrc
source ~/.bashrcInstall rust dependencies.
sudo apt-get update
sudo apt install -y git gcc g++ make cmake pkg-config libssl-dev libclang-dev clang protobuf-compiler💡 5.2. Build Lighthouse from source
mkdir ~/git
cd ~/git
git clone -b stable https://github.com/sigp/lighthouse.git
cd lighthouse
makeVerify lighthouse was installed properly by checking the version number.
lighthouse --version🎩 5.3. Import validator key
Run the following command to import your validator keys from the staking-deposit-cli tool directory.
Enter your keystore password to import accounts.
lighthouse account validator import --network goerli --reuse-password --directory=$HOME/staking-deposit-cli/validator_keysVerify the accounts were imported successfully.
lighthouse account_manager validator list --network goerliWARNING: Do not import your validator keys into multiple validator clients and run them at the same time, or you might get slashed. If moving validators to a new setup or different validator client, ensure deletion of the previous validator keys before continuing.
🔥 5.4. Configure port forwarding and/or firewall
Specific to your networking setup or cloud provider settings, ensure your validator's firewall ports are open and reachable.
Lighthouse consensus client requires port 9000 for tcp and udp
Execution client requires port 30303 for tcp and udp
⛓️ 5.5. Start the beacon chain
Create a systemd unit file to define yourbeacon-chain.service configuration.
sudo nano /etc/systemd/system/beacon-chain.servicePaste the following configuration into the file.
# The eth beacon chain service (part of systemd)
# file: /etc/systemd/system/beacon-chain.service
[Unit]
Description=eth beacon chain service
Wants=network-online.target
After=network-online.target
Documentation=https://www.coincashew.com
[Service]
Type=simple
User=ethereum
Restart=on-failure
ExecStart=/home/ethereum/.cargo/bin/lighthouse bn \
--network goerli \
--staking \
--validator-monitor-auto \
--metrics \
--checkpoint-sync-url=https://goerli.beaconstate.info \
--execution-endpoint http://127.0.0.1:8551 \
--execution-jwt /secrets/jwtsecret
[Install]
WantedBy=multi-user.targetTo exit and save, press Ctrl + X, then Y, thenEnter.
Update file permissions.
sudo chmod 644 /etc/systemd/system/beacon-chain.serviceRun the following to enable auto-start at boot time and then start your beacon node service.
sudo systemctl daemon-reload
sudo systemctl enable beacon-chain
sudo systemctl start beacon-chainNice work. Your beacon chain is now managed by the reliability and robustness of systemd.
🧬 5.6. Start the validator
Create a systemd unit file to define your validator.service configuration.
sudo nano /etc/systemd/system/validator.servicePaste the following configuration into the file.
# The eth validator service (part of systemd)
# file: /etc/systemd/system/validator.service
[Unit]
Description=eth validator service
Wants=network-online.target beacon-chain.service
After=network-online.target
Documentation=https://www.coincashew.com
[Service]
Type=simple
User=<USER>
Restart=on-failure
ExecStart=<HOME>/.cargo/bin/lighthouse vc \
--network goerli \
--metrics \
--suggested-fee-recipient 0x_CHANGE_THIS_TO_MY_ETH_FEE_RECIPIENT_ADDRESS
[Install]
WantedBy=multi-user.targetReplace**
0x_CHANGE_THIS_TO_MY_ETH_FEE_RECIPIENT_ADDRESS** with your own Ethereum address that you control. Tips are sent to this address and are immediately spendable, unlike the validator's attestation and block proposal rewards.
To exit and save, press Ctrl + X, then Y, thenEnter.
Update the configuration file with your current user's home path and user name.
sudo sed -i /etc/systemd/system/validator.service -e "s:<HOME>:${HOME}:g"
sudo sed -i /etc/systemd/system/validator.service -e "s:<USER>:${USER}:g"Update file permissions.
sudo chmod 644 /etc/systemd/system/validator.serviceRun the following to enable auto-start at boot time and then start your validator.
sudo systemctl daemon-reload
sudo systemctl enable validator
sudo systemctl start validatorNice work. Your validator is now managed by the reliability and robustness of systemd.
🛠️ Helpful Consensus Client systemd commands
🗄 Viewing and filtering logs
#view and follow the log
journalctl --unit=beacon-chain -f#view log since yesterday
journalctl --unit=beacon-chain --since=yesterday#view log since today
journalctl --unit=beacon-chain --since=today#view log between a date
journalctl --unit=beacon-chain --since='2020-12-01 00:00:00' --until='2020-12-02 12:00:00'🔎 View the status of the beacon chain
sudo systemctl status beacon-chain🔄 Restarting the beacon chain
sudo systemctl reload-or-restart beacon-chain🛑 Stopping the beacon chain
sudo systemctl stop beacon-chain⏭️ Next Steps
Patience required: If you're checking the logs and see any warnings or errors, please be patient as these will normally resolve once both your execution and consensus clients are fully synced to the Ethereum network.\
How do I know I'm fully synced?
Check your execution client's logs and compare the block number against the most recent block on https://goerli.etherscan.io/
Check EL logs:
journalctl -fu eth1
Check your consensus client's logs and compare the slot number against the most recent slot on https://goerli.beaconcha.in
Check CL logs:
journalctl -fu beacon-chain
🎉 Congrats! You've finished the primary steps of setting up your validator. You're now an Ethereum staker!
👍 Recommended Steps
Subscribe to your Execution Client and Consensus Client's Github repository to be notified of new releases. Hit the Notifications button.
Join the community on Discord and Reddit to discuss all things staking related.
Familiarize yourself with Part II - Maintenance section, as you'll need to keep your staking node running at its best.
Up your staking understanding with the EthStaker Knowledge Base
Finished testing? Before decommissioning your validator, it's good practice to properly exit your validator as this improves staking network health.
🏁 Optional Steps
Setup MEV-boost for extra staking rewards!
Familiarize yourself with Part III - Tips section, as you dive deeper into staking.
☎️ Need extra live support?
Find Ethstaker frens on the Ethstaker Discord and coincashew Discord.
Use reddit: r/Ethstaker, or DMs, or r/coincashew
💟 Like these guides?
Audience-funded guide: If you found this helpful, please consider supporting it directly. 🙏
Support us on Gitcoin Grants: We build this guide exclusively by community support!
Feedback or pull-requests: https://github.com/coincashew/coincashew
Ready for mainnet staking? Mainnet guide available here.
Last Words
I stand upon the shoulders of giants and as such, invite you to stand upon mine. Use my work with or without attribution; I make no claim of "intellectual property." My ideas are the result of countless millenia of evolution - they belong to humanity.
