🖥️ Node Onboarding

Connect remote servers to HFCC in 2 steps

📥 Step 1: Run Onboarding Script on Remote Server

First, download and run the script with the HFCC public key:

# On the HFCC server, generate SSH key:
ssh-keygen -t ed25519 -f ~/.ssh/hfcc_control -N ""
cat ~/.ssh/hfcc_control.pub

# On the REMOTE server, run onboarding:
curl -sL https://hermes.kedahan.net/api/onboarding/script -o onboard.sh
sudo bash onboard.sh "ssh-ed25519 AAAA..."

📋 What The Script Automates

Creates hermes-control service account with restricted sudo
Configures SSH key authentication
Installs Docker Engine + base packages
Installs Node Exporter for metrics (port :9100)
Detects Hermes Agent + GPU
Configures basic UFW firewall
Creates backup directory at /opt/hermes-backups

➕ Step 2: Register in HFCC Dashboard

After the script completes, go to Servers → Add Server:

Name:Friendly name (e.g. "GPU Node 1") Hostname/IP:Server IP or hostname SSH User:hermes-control SSH Port:22 SSH Key:~/.ssh/hfcc_control Environment:production / staging / development

✅ Step 3: Bootstrap & Discover

Click Test Connection

Click Bootstrap Server

Click Discover Agents to find Hermes profiles

Register agents for management

⚠️ Requirements

Ubuntu 20.04+ / Debian 11+
Root access via sudo
SSH reachable from HFCC server (port 22)
Hermes Agent installed (for full management)

← Back to Dashboard ← Back to Home