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

# Troubleshooting

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

```bash
# 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)**

```bash
# 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**

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

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

**Windows (WSL)**

```bash
# 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**

```bash
# Check Docker version
docker --version

# Start Docker service
sudo systemctl start docker

# Verify Docker service status
sudo systemctl status docker
```

**Windows (WSL)**

```powershell
# 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**:

```bash
# 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**

```bash
# Check open ports
sudo ufw status

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

**Windows (WSL)**

```powershell
# 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](https://discord.gg/nesa) for community support and discussion. You can also explore additional documentation to deepen your understanding of Nesa and its features.