Nexus Network

Complete installation guide for running a Nexus node on Testnet III.

---

What is Nexus Network?

Your computer helps process blockchain calculations and you get paid in NEX Points for it.

Nexus Network is a giant worldwide computer made of thousands of normal computers. When you join, your computer does small math problems to help verify blockchain transactions. You earn NEX Testnet Points that turn into NEX Testnet Tokens.

---

Who is This For?

User Type	Use Case
Node Operators	Earn rewards by sharing compute power
Crypto Enthusiasts	Support cutting-edge zkVM technology
Server Owners	Monetize idle hardware
Early Adopters	Get positioned before Mainnet

---

System Requirements

Component	Minimum	Best Performance
CPU	4 cores	8+ cores
RAM	8 GB	16 GB+
Storage	10 GB free	SSD preferred
Internet	Stable connection	Fast & stable

⚠️ Low on RAM? If you have less than 12GB, we'll add swap space to prevent crashes.

---

Quick Start

1. Create Your Account

1. Go to app.nexus.xyz
2. Click "Connect"
3. Sign up with Email or Crypto Wallet
4. Done!

2. Install Nexus (One Command)

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl nano screen git
curl https://cli.nexus.xyz/ | sh
source ~/.bashrc

3. Link Your Node

nexus-network

• Accept Terms of Use: yes
• Link to account: yes
• Log in with your account

4. Run 24/7 with Screen

screen -S nexus
nexus-network start

Press Ctrl+A then D to detach.

---

Technical Documentation

📥 Step-by-Step Installation

STEP 1: Update Your Computer

sudo apt update && sudo apt upgrade -y

Time: 2-5 minutes

STEP 2: Install Basic Tools

sudo apt install -y curl nano screen git

What you're installing:

• curl = Downloads files
• nano = Simple text editor
• screen = Keeps programs running in background
• git = Tool for downloading code

STEP 3: Install Nexus

curl https://cli.nexus.xyz/ | sh

During installation:

• Press Enter when asked questions (accepts defaults)
• Wait 3-5 minutes

STEP 4: Activate Nexus

source ~/.bashrc

STEP 5: Test If It Worked

nexus-network --help

If you see a help menu = SUCCESS!

🔗 Linking Your Node

Link to Your Account

nexus-network

Question 1: Accept Terms of Use?

• Type: yes
• Press: Enter

Question 2: Link to your account?

• Type: yes
• Press: Enter
• Only linked nodes earn points!

Question 3: Login

• Follow instructions to log in
• Use the same email/wallet from app.nexus.xyz

Test Your Node

nexus-network start

Let it run for 2-3 minutes. If you see activity = it's working!

To stop: Press Ctrl+C

🔄 Running 24/7 with Screen

Create Screen Session

screen -S nexus

Start Your Node

nexus-network start

Leave It Running

1. Press Ctrl+A (hold both keys)
2. Release both keys
3. Press D (just the D key)

You should see: "detached from screen"

Your node is now running in the background!

Manage Your Node

Command	Description
screen -ls	Check if node is running
screen -r nexus	View your running node
screen -X -S nexus quit	Stop your node

🔁 Auto-Start on Reboot

Create the Script

nano ~/start-nexus.sh

Paste this:

#!/bin/bash
sleep 60
screen -X -S nexus quit 2>/dev/null
screen -dmS nexus nexus-network start
echo "$(date): Started nexus node" >> ~/nexus-startup.log

Save: Ctrl+X, Y, Enter

Make Script Runnable

chmod +x ~/start-nexus.sh

Set to Run on Boot

crontab -e

Add this line at the bottom:

@reboot /home/YOUR_USERNAME/start-nexus.sh

Replace YOUR_USERNAME with your actual username (check with whoami).

Test

sudo reboot
# After restart, wait 60 seconds
screen -ls

If you see "nexus" = Auto-start works!

🛟 Fix Low Memory Problems

Create Swap File (16GB)

sudo fallocate -l 16G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Verify

free -h

Look for "Swap:" line - should show 16GB.

⚡ Advanced Commands

Manual Node Management

Register your wallet:

nexus-network register-user --wallet-address YOUR_WALLET_ADDRESS

Register a new node:

nexus-network register-node

Start with specific node ID:

nexus-network start --node-id YOUR_NODE_ID

Logout/unlink:

nexus-network logout

View Configuration

cat ~/.nexus/config.json

Performance Monitoring

htop           # System monitor (Q to exit)
free -h        # RAM usage
df -h          # Disk space
speedtest-cli  # Internet speed

Find Your IP

hostname -I      # Local IP
curl ifconfig.me # Public IP

🔧 Troubleshooting

"Command Not Found"

source ~/.bashrc
nexus-network --help

Still not working? Reinstall:

curl https://cli.nexus.xyz/ | sh
source ~/.bashrc

"Node Won't Connect"

ping -c 4 google.com  # Check internet
screen -X -S nexus quit
screen -S nexus
nexus-network start

"Node Not in Dashboard"

1. Stop node: screen -X -S nexus quit
2. Run: nexus-network
3. Link to account
4. Start node again
5. Wait 5 minutes, refresh dashboard

"Out of Memory"

Follow the swap file instructions above.

"Low Points / Slow Earning"

• Check if node keeps disconnecting
• Use screen and auto-start for 24/7 uptime
• Ensure node is linked to your account

---

Quick Commands

Node Commands

Action	Command
Start node (test)	nexus-network start
See all options	nexus-network --help
Stop node	Ctrl+C
Link to account	nexus-network
Logout/unlink	nexus-network logout

Screen Commands

Action	Command
Create session	screen -S nexus
List sessions	screen -ls
View node	screen -r nexus
Leave running	Ctrl+A then D
Stop node	screen -X -S nexus quit

System Commands

Action	Command
Check RAM	free -h
Monitor resources	htop
Check disk space	df -h
Your username	whoami
Your IP	hostname -I

---

How You Earn

NEX Testnet Points

• Automatically earned while node is running
• Check at app.nexus.xyz

Earn More Points

• Run 24/7 - More uptime = more points
• Keep it linked - Anonymous nodes earn nothing
• Good hardware - Faster CPU = more computations
• Stable internet - Less disconnections
• Multiple devices - Up to 100 nodes per account

---

Important Links

Resource	Link
Dashboard	app.nexus.xyz
Node Management	app.nexus.xyz/nodes
Documentation	docs.nexus.xyz
Discord	discord.gg/nexus-xyz

---

Security Warning

🚨 SCAM ALERT

Nexus support will NEVER:

• ❌ Send you a private message first
• ❌ Ask for your password or private keys
• ❌ Ask you to send money or crypto

Real support is ONLY in:

• ✅ Discord public channels
• ✅ GitHub issues
• ✅ Official docs

If someone messages you claiming to be support = IT IS A SCAM!

---

Contributing

Contributions welcome! Feel free to submit issues or pull requests.

---

Disclaimer

This is a Testnet - real tokenomics come with Mainnet. Point rates may change. Keep earning to be ready for Mainnet rewards!

---

Built by @bokiko

Join the verifiable computing revolution