Troubleshooting

Here are some common problems and their solutions

Introduction

This section provides solutions to common issues encountered during the installation and operation of a Nesa node.

---

Script Fails to Download or Execute

Possible Reasons and Solutions:

• Network Issues: Ensure your internet connection is stable.

• Incorrect Command: Verify the command syntax.

Steps to Verify and Fix:

Linux/macOS

# Check network connectivity
ping google.com

# Verify curl installation
curl --version

# Correct command to download and execute the script
curl -L https://raw.githubusercontent.com/nesaorg/bootstrap/master/bootstrap.sh | bash

Windows (WSL)

# Check network connectivity
ping google.com

# Verify curl installation
curl --version

# Correct command to download and execute the script
curl -L https://raw.githubusercontent.com/nesaorg/bootstrap/master/bootstrap.sh | bash

---

Permission Denied Errors

Explanation of Permission Issues:

• Insufficient permissions to execute the script or install software.

Resolution Steps:

Linux/macOS

# Ensure the script is executable
chmod +x bootstrap.sh

# Run the script with sudo
sudo ./bootstrap.sh

Windows (WSL)

# Ensure the script is executable
chmod +x bootstrap.sh

# Run the script with elevated privileges
sudo ./bootstrap.sh

---

Docker-Related Issues

Common Issues and Solutions:

• Docker Not Running: Ensure Docker service is active.

• Installation Issues: Reinstall Docker if necessary.

Verify Docker Installation and Status:

Linux/macOS

# Check Docker version
docker --version

# Start Docker service
sudo systemctl start docker

# Verify Docker service status
sudo systemctl status docker

Windows (WSL)

# Check Docker version
docker --version

# Start Docker service from Docker Desktop
Start-Process 'C:\Program Files\Docker\Docker\Docker Desktop.exe'

---

Node Configuration Problems

Troubleshooting Configuration Issues:

• Incorrect moniker or node type selection.

Reconfiguration Steps:

# Rerun the script to reconfigure the node
./bootstrap.sh

---

Connectivity Issues

Diagnosing Network Problems:

• Firewall Restrictions: Ensure necessary ports are open.

• Network Configuration: Verify network settings.

Steps to Fix Connectivity Issues:

Linux/macOS

# Check open ports
sudo ufw status

# Allow necessary ports (example for port 26656)
sudo ufw allow 26656

Windows (WSL)

# Check open ports in Windows Firewall
Get-NetFirewallRule -All

# Allow necessary ports (example for port 26656)
New-NetFirewallRule -DisplayName "Allow Nesa Node" -Direction Inbound -Protocol TCP -LocalPort 26656 -Action Allow

---

Additional Help/Support

If you need any additional help or support, please visit the Nesa Discord for community support and discussion. You can also explore additional documentation to deepen your understanding of Nesa and its features.