FAQ
Frequently asked questions and answers
Introduction
This section addresses common questions about setting up and running a Nesa node.
What is a Nesa node?
A Nesa node is a server that participates in the Nesa blockchain network, either by validating transactions (Validator) or by handling inference tasks for AI models (Miner).
What are the hardware requirements for running a Nesa node?
CPU: Multi-core processor
Memory: 4 GB RAM minimum
Storage: 50 GB free disk space (or more depending on the size of the model(s) you plan to power)
How do I view my node's performance?
Visit https://node.nesa.ai and enter your Node ID.
You can find your Node ID by re-running the bootstrap script and reading it from the script's header.
How do I install Docker?
Linux:
# Add Docker's official GPG key: sudo apt-get update sudo apt-get install ca-certificates curl sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc sudo chmod a+r /etc/apt/keyrings/docker.asc # Add the repository to APT sources: echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin # Example command to install Docker on macOS using Homebrew brew install --cask docker # Example command to install Docker on Windows using PowerShell choco install docker-desktop
macOS:
brew install --cask docker
Windows (WSL):
choco install docker-desktop
How do I configure my node as a Validator or Miner?
During the bootstrap script execution, you will be prompted to select a node type:
Validator: Enter the private key for the validator.
Miner: Choose between Distributed Miner or Non-Distributed Miner, and select or enter a model.
What should I do if the bootstrap script fails to run?
Verify network connectivity
Check curl installation
Run the script with appropriate permissions
# For all operating systems
curl -L https://raw.githubusercontent.com/nesaorg/bootstrap/master/bootstrap.sh | bash
How do I check if my node is running correctly?
Verify Docker containers status:
docker ps
Ensure all required Docker containers are running.
What are swarms, and how do I join or start one?
A swarm is an orchestrator and miner(s) working collaboratively to handle inference tasks. During the bootstrap script execution, you may:
Join an existing swarm: Select from a list of available swarms.
Start a new swarm: Enter the model name to run.
Advanced: Can I override my node's model cache directory?
Yes, set your preferred cache directory using the HF_HOME
variable in ~/.nesa/env/orchestrator.env
.
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