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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nesa.ai/nesa/run-a-nesa-node/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.