> For the complete documentation index, see [llms.txt](https://blocx.gitbook.io/blocx./llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://blocx.gitbook.io/blocx./validator-node/troubleshooting.md).

# 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:

   ```bash
   ls -la el-cl-genesis-data
   ```
2. Try unpacking the genesis data again:

   ```bash
   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:

   ```bash
   sudo netstat -tulpn | grep -E '8545|5052|9000|30303'
   ```
2. Ensure Docker is running:

   ```bash
   sudo systemctl status docker
   ```
3. Check Docker Compose logs:

   ```bash
   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:

   ```bash
   curl https://ipinfo.io/ip
   ```
3. Ensure your ISP is not blocking peer-to-peer connections.