Installation

Complete installation guide for One-ADN node application

Installation Guide

This guide covers all installation methods for the One-ADN node application across different operating systems and environments.

System Requirements#

Minimum Requirements#

| Component | Specification | |-----------|---------------| | CPU | 4 cores, 2.5 GHz | | RAM | 16 GB | | Storage | 100 GB SSD | | GPU | NVIDIA GTX 1080 or equivalent | | Network | 100 Mbps |

Recommended Requirements#

| Component | Specification | |-----------|---------------| | CPU | 8+ cores, 3.5 GHz | | RAM | 64 GB | | Storage | 500 GB NVMe SSD | | GPU | NVIDIA RTX 4090 or A100 | | Network | 1 Gbps |

Installation Methods#

Method 1: Using npm (Recommended)#

The simplest way to install One-ADN:

bash

# Install globally
npm install -g @one-adn/node

# Verify installation
one-adn --version

Method 2: Using Docker#

For containerized deployments:

bash

# Pull the official image
docker pull ghcr.io/one-adn/node:latest

# Run with GPU support
docker run --gpus all -d \
  --name one-adn-node \
  -p 7545:7545 \
  -v $(pwd)/config:/app/config \
  ghcr.io/one-adn/node:latest

Method 3: Build from Source#

For developers who want to customize:

bash

# Clone the repository
git clone https://github.com/one-adn/node.git
cd node

# Install dependencies
npm install

# Build the project
npm run build

# Link globally
npm link

Platform-Specific Instructions#

Linux (Ubuntu/Debian)#

bash

# Install NVIDIA drivers
sudo apt update
sudo apt install nvidia-driver-535

# Install CUDA toolkit
sudo apt install nvidia-cuda-toolkit

# Verify GPU
nvidia-smi

# Install One-ADN
npm install -g @one-adn/node

macOS#

bash

# Install Homebrew if not present
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js
brew install node

# Install One-ADN
npm install -g @one-adn/node

Note: GPU acceleration on macOS uses Metal framework for Apple Silicon.

Windows#

Install NVIDIA CUDA Toolkit
Install Node.js LTS
Open PowerShell as Administrator:

powershell

# Install One-ADN
npm install -g @one-adn/node

# Verify installation
one-adn --version

Post-Installation Setup#

Initialize Configuration#

bash

# Create config directory
mkdir -p ~/.one-adn

# Initialize with defaults
one-adn init

# Or with custom settings
one-adn init --gpu-memory 16GB --port 7545

Configure Environment Variables#

Create a .env file or set system environment variables:

bash

# API Configuration
ONE_ADN_API_KEY=your-api-key-here
ONE_ADN_NODE_ID=custom-node-id

# Network Settings
ONE_ADN_PORT=7545
ONE_ADN_DISCOVERY=true

# GPU Settings
ONE_ADN_GPU_ENABLED=true
ONE_ADN_GPU_MEMORY=16GB

Verify Installation#

Run the diagnostic command:

bash

one-adn doctor

Expected output:

One-ADN System Diagnostic
-------------------------
Node.js version: v20.10.0
GPU detected: NVIDIA RTX 4090
CUDA version: 12.1
Memory available: 64 GB
Disk space: 450 GB free
Network: Connected
Status: Ready to join network

Troubleshooting#

Common Issues#

GPU not detected:

bash

# Check NVIDIA driver
nvidia-smi

# Reinstall CUDA
sudo apt install --reinstall nvidia-cuda-toolkit

Port already in use:

bash

# Find process using port
lsof -i :7545

# Use different port
one-adn start --port 7546

Permission denied:

bash

# Fix npm permissions
sudo chown -R $USER ~/.npm
sudo chown -R $USER /usr/local/lib/node_modules

Next Steps#

After installation: