English
Guide | How to setup a validator for Ethereum staking on Pithos testnet in 10 minutes or less
Become a validator, start staking and help secure Ethereum, a proof-of-stake blockchain. Anyone with 32 ETH can join.

Your Mission

To participate in the public testnet known as Pithos, which is the public's first glimpse in helping Ethereum's journey towards "The Merge", where Ethereum will transition from proof of work to a much more sustainable proof of stake consensus model.
Major props and credits to parithosh for this knowledge share. Without his extensive work and dedication, this guide would not be possible.
The MergETHEREUM Panda
Learn more about the Merge: https://ethmerge.com/

Prerequisites

This guide was tested against Ubuntu 20.04.1 LTS client. You'll need a virtual machine or local desktop/server/laptop/RaspberryPi.

Minimum Hardware Requirements

  • Operating system: 64-bit Linux (i.e. Ubuntu 20.04 LTS Server or Desktop)
  • Processor: Dual core CPU, Intel Core i5–760 or AMD FX-8100 or better
  • Memory: 4GB RAM
  • Storage: 16GB SSD
For examples of actual staking hardware builds, check out RocketPool's hardware guide.
Pro Staking Tip: Highly recommend you begin with a brand new instance of an OS, VM, and/or machine. Avoid headaches by NOT reusing testnet keys, wallets, or databases for your validator.

How to participate with Pithos

At present, only the consensus beacon client and execution client are available now. Consensus layer's validator client are coming soon.

1. Install dependencies and updates

Install packages and update OS
1
sudo apt-get update && sudo apt-get upgrade -y
2
sudo apt-get install git ufw curl -y
Copied!
Install Docker
1
curl -fsSL https://get.docker.com -o get-docker.sh
2
sudo sh get-docker.sh
3
sudo usermod -aG docker $USER
Copied!
Install Docker Compose
1
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
2
sudo chmod +x /usr/local/bin/docker-compose
Copied!
Verify docker and docker-compose installed properly.
1
docker --version
2
docker-compose --version
Copied!
Sample output of known working versions.
Docker version 20.10.9, build c2ea9bc
docker-compose version 1.29.2, build 5becea4c
Reboot your machine to complete docker installation.
1
sudo reboot
Copied!

2. Configure Firewall

Initialize the firewall with Ethereum's p2p ports and ssh.
More comprehensive staking validator node security best practices also available.
1
# By default, deny all incoming and outgoing traffic
2
sudo ufw default deny incoming
3
sudo ufw default allow outgoing
4
5
# Allow SSH access
6
sudo ufw allow ssh
7
8
# Allow execution client port
9
sudo ufw allow 30303/tcp
10
11
# Allow consensus client port
12
sudo ufw allow 9000/tcp
13
sudo ufw allow 9000/udp
14
15
# Enable UFW
16
sudo ufw enable
Copied!
Confirm the settings are in effect.
1
sudo ufw status numbered
Copied!
Example output:
1
Status: active
2
3
To Action From
4
-- ------ ----
5
[ 1] 9000/udp ALLOW IN Anywhere
6
[ 2] 22/tcp ALLOW IN Anywhere
7
[ 3] 30303/tcp ALLOW IN Anywhere
8
[ 4] 9000/tcp ALLOW IN Anywhere
9
[ 5] 9000/udp (v6) ALLOW IN Anywhere (v6)
10
[ 6] 22/tcp (v6) ALLOW IN Anywhere (v6)
11
[ 7] 30303/tcp (v6) ALLOW IN Anywhere (v6)
12
[ 8] 9000/tcp (v6) ALLOW IN Anywhere (v6)
Copied!
For optimal connectivity, ensure Port Forwarding is setup for your router.

3. Setup Pithos ansible files

1
#Setup git directory
2
mkdir ~/git
3
cd ~/git
4
5
#Clone the repository
6
git clone https://github.com/parithosh/consensus-deployment-ansible
7
8
#Change directories
9
cd ~/git/consensus-deployment-ansible/scripts/quick-run/
10
11
#Create the required directories for persistent data
12
mkdir -p execution_data beacon_data
Copied!

4. Set IP Address

Set your public IP address into the pithos.vars file. Ensure your IP address is correct by cross checking with https://www.whatismyip.com.
1
IP_ADDRESS=$(curl ifconfig.me)
2
echo My IP address: $IP_ADDRESS
3
sed -i -e "s/<ENTER-IP-ADDRESS-HERE>/$IP_ADDRESS/g" ~/git/consensus-deployment-ansible/scripts/quick-run/pithos.vars
Copied!

5. Run the execution and consensus clients

Choose and start up your execution client.
Geth
Besu
1
docker-compose --env-file pithos.vars -f docker-compose.geth.yml up -d
Copied!
1
docker-compose --env-file pithos.vars -f docker-compose.besu.yml up -d
Copied!
Choose and start up your consensus client.
Lodestar
Teku
Lighthouse
1
docker-compose --env-file pithos.vars -f docker-compose.lodestar.yml up -d
Copied!
1
docker-compose --env-file pithos.vars -f docker-compose.teku.yml up -d
Copied!
1
docker-compose --env-file pithos.vars -f docker-compose.lighthouse.yml up -d
Copied!
Check your logs to confirm that the execution and consensus clients are up and syncing.
Geth
Besu
1
docker logs geth -f --tail=20
Copied!
1
docker logs besu -f --tail=20
Copied!
Lodestar
Teku
Lighthouse
1
docker logs lodestar_beacon -f --tail=20
Copied!
1
docker logs teku_beacon -f --tail=20
Copied!
1
docker logs lighthouse_beacon -f --tail=20
Copied!
Syncing is complete when your slot number matches that of a block explorers. Check https://pithos-explorer.ethdevops.io/
Since the network is relatively new, syncing both the execution and consensus layers should take a few minutes or so.
Congrats on setting up your Pithos staking node!
Note: Validator Deposits not yet available. Deposits for general public should be available in a week.
If you haven't already, learn to setup a Validator for Ethereum Staking.

Additional Information

Stopping the execution and consensus clients

To stop the clients, run
Geth
Besu
1
docker-compose -f docker-compose.geth.yml down
Copied!
1
docker-compose -f docker-compose.besu.yml down
Copied!
Lodestar
Teku
Lighthouse
1
docker-compose -f docker-compose.lodestar.yml down
Copied!
1
docker-compose -f docker-compose.teku.yml down
Copied!
1
docker-compose -f docker-compose.lighthouse.yml down
Copied!

Troubleshooting

View the current running docker processes.
1
docker ps
Copied!
Example output:
1
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
2
592fd5931a1b parithoshj/geth:merge-ac736f9 "geth --datadir=/exe…" 1 hours ago Up 1 hours geth
Copied!
Notice the column under NAMES. In this example, it's geth.
We can shutdown and clean the container by calling geth's yml filename (e.g docker-compose.geth.yml). Update this filename for your specific execution or consensus client.
1
docker-compose -f docker-compose.geth.yml down --remove-orphans
Copied!

Change Ports

Scenario: The default ports 30303 and 9000 are already in use and you need to change ports.
Edit the appropriate docker .yml file. e.g. docker-compose.geth.yml
Add this to the command line.
1
--port <your port#>
Copied!
Update UFW firewalls and/or port forwarding rules accordingly.

Reference Material

Last modified 2mo ago