LogoLogo
  • Nesa Docs
    • Introduction to Nesa
    • Overview of the Nesa System
      • AI Models: Repository, Standardization, Uniformity
      • Users: Why Do We Need Private Inference?
      • Node Runners: Doing Inference and Earning $NES
    • Organization of the Documentation
  • Technical Designs
    • Decentralized Inference
      • Overview
      • Model Partitioning and Deep Network Sharding
      • Dynamic Sharding of Arbitrary Neural Networks
      • Cache Optimization to Enhance Efficiency
      • BSNS with Parameter-efficient Fine-tuning via Adapters
      • Enhanced MTPP Slicing of Topological Order
      • Swarm Topology
      • Additional: Free-Riding Prevention
    • Security and Privacy
      • Overview
      • Hardware Side: Trusted Execution Environments (TEEs)
      • Software/algorithm Side: Model Verification
        • Zero-knowledge Machine Learning (ZKML)
        • Consensus-based Distribution Verification (CDV)
      • Software/algorithm Side: Data Encryption
        • Visioning: Homomorphic Encryption
        • Implementation: Split Learning (HE)
      • Additional Info
        • Additional Info: Trusted Execution Environments (TEEs)
        • Additional Info: Software-based Approaches
    • Overview of $NES
      • $NES Utility
    • The First Application on Nesa: DNA X
    • Definitions
    • Additional Information
      • Dynamic Model Versioning and Fork Management
      • Nesa's Utility Suite
      • The AI Kernel Market
      • Privacy Technology
        • Trusted Execution Environment (TEE)
        • Secure Multi-Party Computation (MPC)
        • Verifiable Random Function (VRF)
        • Zero-Knowledge Proof (ZKP)
      • The Integration of Evolutionary AI to Evolve the Nesa Ecosystem
      • Interoperability and Nesa Future Plans
  • Using Nesa
    • Getting Started
      • Wallet Setup
      • Testnet Nesa Faucet
    • Via Web
      • Your Nesa Account
      • Selecting an AI Kernel
      • Submitting a Query
    • Via SDK
    • Via IBC
    • Via NESBridge
      • On Sei
  • Run a Nesa Node
    • Prerequisites
    • Installation
    • Troubleshooting
    • FAQ
  • Links
    • nesa.ai
    • Nesa Discord
    • Nesa Twitter
    • Nesa dApp: dnax.ai
    • Nesa dApp: DNA X Docs
    • Terms of Service
    • Privacy Policy
Powered by GitBook
On this page
  • Introduction
  • What is a Nesa node?
  • What are the hardware requirements for running a Nesa node?
  • How do I view my node's performance?
  • How do I install Docker?
  • How do I configure my node as a Validator or Miner?
  • What should I do if the bootstrap script fails to run?
  • How do I check if my node is running correctly?
  • What are swarms, and how do I join or start one?
  • Advanced: Can I override my node's model cache directory?
  1. Run a Nesa Node

FAQ

Frequently asked questions and answers

PreviousTroubleshooting

Last updated 8 months ago

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 and enter your Node ID.

You can find your Node ID by re-running the 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 for community support and discussion. You can also explore additional documentation to deepen your understanding of Nesa and its features.

https://node.nesa.ai
bootstrap script
Nesa Discord