🆘Troubleshooting

Common Errors and Solutions

Error: "Failed to initialize execution client"

Symptoms:

• Error message during initialization

• Node fails to start

Solutions:

1. Ensure genesis data is present:

   ls -la el-cl-genesis-data

2. Try unpacking the genesis data again:

   tar -xzvf el-cl-genesis-data.tar.gz

3. Try running the initialization again (option 2 in the menu).

Error: "Failed to start validator node"

Symptoms:

• Node containers fail to start

• Docker Compose error messages

Solutions:

1. Check for port conflicts:

   sudo netstat -tulpn | grep -E '8545|5052|9000|30303'

2. Ensure Docker is running:

   sudo systemctl status docker

3. Check Docker Compose logs:

   docker compose -f compose-validator.yaml logs

Sync Issues

Problem: Node is not syncing or syncing extremely slowly

Symptoms:

• No peers are connected

• Sync progress is stalled

• Progress percentage not increasing

Solutions:

1. Check your internet connection:

   ping -c 5 google.com

2. Verify DNS resolution:

   nslookup google.com

3. Ensure ports are open on your firewall:

   sudo ufw status

4. Restart the node:

   docker compose -f compose-validator.yaml down
   docker compose -f compose-validator.yaml up -d

Connection Problems

Problem: Cannot connect to peers

Symptoms:

• Low peer count

• Connection errors in logs

Solutions:

1. Check if ports are properly forwarded on your router/firewall.

2. Verify your public IP is correctly configured:

   curl https://ipinfo.io/ip

3. Ensure your ISP is not blocking peer-to-peer connections.