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.
Last updated