Before You Begin
Prerequisites
Make sure you have the following before installing SVRN Node.
Node.js 22 or later
Download from nodejs.org or use nvm install 22
A NoxSoft account
Sign up at auth.noxsoft.net — free, takes 30 seconds
A stable internet connection
Required for receiving and completing network tasks
Quick Start
Up and running in 4 steps.
Install SVRN Node
Install the SVRN Node CLI globally via npm.
This installs the svrn-node command globally on your system.
Link Your Account
Connect your node to your NoxSoft account so your earnings flow to your wallet.
This opens your browser where you sign in with your NoxSoft account. Once authenticated, your node is automatically linked. Your earned UCU flows directly to your NoxSoft wallet.
Start Your Node
Begin contributing compute to the SVRN network and earning UCU.
Your node starts accepting and completing tasks from the network. You will see your username, wallet address, and earnings updating in real-time in the terminal dashboard.
Check Your Earnings
See your node status, linked account, and accumulated UCU at any time.
Example Output
Account Linking
Connect your node to NoxSoft.
When you run svrn-node login, it opens your browser for authentication. After signing in with your NoxSoft account, your node is permanently linked. All UCU earned by your node is automatically associated with your account.
SVRN Node
Earns UCU from tasks
NoxSoft Account
Receives UCU transfers
NoxSoft Products
UCU offsets costs
How do I check my linked account?
Run svrn-node status to see the email address and public key associated with your node.
Can I link multiple nodes to one account?
Yes. Each node you run can be linked to the same NoxSoft account. Earnings from all nodes are aggregated in your wallet.
How do I unlink my account?
Run svrn-node logout to unlink. Earned UCU remains in your NoxSoft wallet.
Fund Transfer
Automatic UCU transfers to your account.
UCU earned by your node is automatically transferred to your NoxSoft account every hour. You can configure the transfer interval, set minimum balance thresholds, or disable auto-transfer entirely.
Transferred funds appear in your NoxSoft wallet and automatically offset subscription costs across all NoxSoft products.
Auto-transfer configuration
enabled— Toggle automatic transfers on or offintervalMinutes— How often to transfer (default: 60 minutes)minBalance— Minimum UCU balance before a transfer triggers (default: 0.1 UCU)Configuration
Tune your node to your hardware.
SVRN Node is fully configurable. Set resource limits, choose which task types to accept, and control update behavior. Configuration lives at ~/.svrn/config.json.
Resource Limits
CPU: Default 50%. Set lower on laptops, higher on dedicated servers.
RAM: Default 512MB. Increase for compute-heavy tasks.
Bandwidth: Default 10 Mbps. Controls relay and data transfer speed.
Storage: Default 5GB. Used for encrypted data shard storage.
Task Types
ping: Minimal resources. Network health checks.
relay: Low resources. Route encrypted data between nodes.
compute: Medium resources. AI inference and data processing.
store: Low resources. Persist encrypted data shards.
validate: Medium resources. Verify outputs from other nodes.
Reference
Common commands.
FAQ
Frequently asked questions.
How much can I earn?
Is it safe?
Does it slow my computer?
~/.svrn/config.json. Most users report no noticeable impact on daily usage.How do I use my UCU?
Can I run multiple nodes?
svrn-node login on each machine to link them all to the same NoxSoft account. Earnings from every node aggregate in your single wallet.How do I unlink my account?
svrn-node logout. This unlinks the node from your NoxSoft account. Any UCU already transferred to your NoxSoft wallet stays there. The node can continue running unlinked, accumulating UCU in its local wallet until you link again.What happens if I stop my node?
Troubleshooting
Common issues and fixes.
Node won't start
Check if another instance is already running: svrn-node status
Make sure Node.js 22+ is installed: node --version
Check if port 9470 is available, or change it in your config
Try reinstalling: npm install -g @noxsoft/svrn-node@latest
Can't login / authentication fails
Make sure you have a NoxSoft account at auth.noxsoft.net
Check that your default browser can open (the login flow uses browser-based auth)
Try clearing your node credentials: svrn-node logout then svrn-node login
Low earnings
Increase resource limits in ~/.svrn/config.json — higher limits means more tasks accepted
Ensure stable internet — dropped connections mean missed tasks
Accept more task types (especially compute and validate which pay more)
Maximize uptime — nodes that are consistently online get prioritized for tasks
Update issues
Run svrn-node update to check for and install the latest version
Or update manually: npm install -g @noxsoft/svrn-node@latest
If auto-update fails, check write permissions to the global npm directory
UCU not appearing in NoxSoft account
Transfers happen at the configured interval (default: every 60 minutes)
Check that auto-transfer is enabled: svrn-node config
Verify your account is linked: svrn-node status should show your email
If your balance is below the minBalance threshold, the transfer waits until it accumulates enough
Ready to start earning?
Install SVRN Node, contribute your idle compute, and make every NoxSoft product free.
npm install -g @noxsoft/svrn-node