> For the complete documentation index, see [llms.txt](https://docs.netsepio.com/latest/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.netsepio.com/latest/erebrus/nodes/nexus-node.md).

# Nexus Node

## Nexus Node Overview

The Nexus Node is a high-performance node designed for AI workloads, application orchestration, and decentralized VPN. Unlike the Beacon Node, which primarily functions as a VPN relay, Nexus Nodes provide AI Agent hosting, firewall deployment, and global DNS assignment for applications deployed by users.

Running a Nexus Node allows you to earn rewards for sharing compute and storage resources, supporting decentralized AI coordination and censorship-resistant applications. Operators must have a static IP and a wildcard domain to enable seamless deployment and connectivity. While a home lab setup is possible, cloud deployment is recommended for performance and reliability.

By hosting a Nexus Node, you help build a resilient AI coordination layer, enabling users to deploy AI agents, self-hosted apps like Nextcloud, and privacy-enhancing tools.

## **Prerequisites**

### **Hardware Requirements**

* Operating System: `Linux`
* Minimum Hardware Requirements:
  * `8GB RAM` (Recommended: `16GB+`)
  * `4 vCPUs` (Recommended: `8 vCPUs`)
  * `200GB+` SSD storage (Recommended: `500GB+` for AI Agents hosting)
  * Static IP required
  * Domain and Wildcard domain (for App Orchestration & DDNS Assignment)

### **Network Requirements**

* Incoming traffic allowed on ports:
  * `51820` (WireGuard VPN)
  * `9002` (LibP2P peer discovery)
  * `443 & 80` (Web applications & API access)
* A stable, high-bandwidth internet connection (preferably wired)
* Basic familiarity with command-line interface (CLI) i.e. terminal
* Node Wallet (i.e. valid mnemonic on the supported chain) for on-chain registration and checkpoint

## **Estimated Cloud Deployment Costs** *(Per Month)*

Nexus Nodes require higher computing power, making cloud deployment preferable. Here’s an estimated monthly cost based on recommended specifications:

<table><thead><tr><th width="121.60546875">Cloud Provider</th><th width="121.9140625">Instance Type</th><th width="93.77734375">CPU</th><th width="68.2734375">RAM</th><th width="115.28125">Storage</th><th width="111.5234375">Static IP</th><th width="127.72265625">Estimated Cost</th></tr></thead><tbody><tr><td><strong>Hetzner</strong></td><td>AX41</td><td>8 vCPUs</td><td>16GB</td><td>512GB SSD</td><td>✅ Included</td><td>~$50/month</td></tr><tr><td><strong>AWS EC2</strong></td><td>t3.xlarge</td><td>4 vCPUs</td><td>16GB</td><td>500GB SSD</td><td>✅ $5 extra</td><td>~$90/month</td></tr><tr><td><strong>DigitalOcean</strong></td><td>General Droplet</td><td>8 vCPUs</td><td>16GB</td><td>500GB SSD</td><td>✅ $5 extra</td><td>~$80/month</td></tr><tr><td><strong>Vultr</strong></td><td>High-Performance</td><td>8 vCPUs</td><td>16GB</td><td>500GB SSD</td><td>✅ Included</td><td>~$60/month</td></tr></tbody></table>

## **License & Staking Requirements**

* **License Fee:** A Node License NFT is required to run a Nexus Node.
* **Staking Requirement:** **150 USD** (Currently **$0 USD**)
  * Ensures great user experience while improving stability and preventing spam deployments.
  * Higher staking incentivizes reliable operators.
  * Staking requirement changes based on demand & supply.
* **Revenue Model:** Earn rewards for both:
  * Enabling encrypted, censorship-resistant VPN
  * Hosting AI Agents & decentralized apps

## **Installation**

#### **1. Install the Node Software**

Run the following command in your terminal:

```bash
curl -s https://raw.githubusercontent.com/NetSepio/erebrus/main/install-node.sh -o install.sh && sudo bash install.sh
```

Follow the on-screen instructions to install dependencies.

#### **2. Configure the Node**

* Set up public IP and wildcard domain.
* Choose resource allocation for AI compute & app hosting.
* Configure firewall settings for security.

#### **3. Verify Configuration**

* Ensure all necessary ports are open.
* Test AI workload execution & VPN reachability.

Once the configuration is verified, the Nexus Node will become active and start processing hosting tasks & handle VPN client connections.

## **Maintenance & Monitoring**

* Update your node software regularly for performance & security patches.
* Monitor system usage (CPU, RAM, storage) to ensure smooth operation.
* Use logging tools to track AI task execution & app deployments.

## **Troubleshooting**

1. **AI Agents Not Running or Get Stopped Frequently**

   Issue: AI Agents fail to run properly.\
   Solution: Ensure enough RAM & storage is allocated and dependencies (Caddy, Docker, Git) are installed and configured correctly.
2. #### **Wildcard Domain Not Resolving**

   **Issue:** Apps hosted on the node are inaccessible.\
   **Solution:** Check your DNS settings and verify that the wildcard domain points to your static IP.
3. #### **Firewall Blocking Traffic**

   **Issue:** Users can't connect to your node.\
   **Solution:** Ensure the required ports are open in your firewall settings.

## **Additional Resources**

* Security Best Practices: Keep SSH secure & regularly update node software and dependencies.
* Community Support: Join the NetSepio Discord Server for troubleshooting & network insights.