// Section 14.3 · Operate
Install and Bootstrap
One line installs. One command sets up.
// 14.3 · install and bootstrap · macos + linux · windows via wsl2
Key claim
The node key never leaves the machine: a separate, low-value secp256k1 key that signs liveness and results only, never the staking wallet's key.
The one-line installer at https://parallelix.io/install.sh goes from nothing to a running CLI: Node.js, the Ollama inference runtime (GPU auto-detected), and parallelix-node v2.0.0. macOS is supported the same way; native Windows is not, so Windows operators run everything inside WSL2. After the installer, run parallelix-node setup: five guided steps from hardware detection to a prefilled Console staking link, with nodeId auto-detection once the stake lands. All state lives under ~/.parallelix/.
What the installer and setup do
// node · ollama · cli · setup five steps
CURL THE ONE-LINER
Run `curl -fsSL https://parallelix.io/install.sh | sh`. Installs Node.js LTS, Ollama, and parallelix-node. Offers to run setup immediately.
NODE.JS
Installs Node.js LTS if it is missing or older than 18. The CLI is a small Node program; this is its only language runtime.
OLLAMA
Installs Ollama via its official installer (which auto-detects the GPU) and starts it. Ollama is the open-source LLM runtime that actually executes inference.
PARALLELIX-NODE
Downloads parallelix-node from https://parallelix.io/cli/parallelix-node.mjs and places a shim at /usr/local/bin/parallelix-node.
SETUP (ONE COMMAND)
Run `parallelix-node setup`. Five guided steps: [1/5] hardware detect + tier, [2/5] Ollama check, [3/5] model recommend + pull (largest fitting 90% VRAM), [4/5] node key generation (separate low-value key, never the staking wallet), [5/5] prefilled Console staking link. Auto-detects the nodeId when the stake lands and offers service install. Re-running resumes safely.
Sample install and setup session
// bash · installer then setup · ready to stake and attach
# Install · Node + Ollama + parallelix-node, in one line
$ curl -fsSL https://parallelix.io/install.sh | sh
✓ Node v22.x present
✓ Ollama running
✓ parallelix-node installed
# One-command setup · hardware detect, model pull, key gen, staking link
$ parallelix-node setup
[1/5] hardware NVIDIA RTX 4090 · 24 GB VRAM · tier 3 (GPU · high)
[2/5] ollama running
[3/5] model recommend: qwen2.5:14b (11 GB, fits 90% VRAM)
pulling qwen2.5:14b ... ✓
[4/5] node key generated at ~/.parallelix/node.key (0600)
nodeKeyHash 0x9c27a4...
[5/5] stake now https://app.parallelix.io/operate/stake?tier=3&keyHash=0x9c27a4...
waiting for on-chain registration ...
detected nodeId 4217 · saved to config
install as service? [y/N]:Supported targets
// macos + linux live · windows via wsl2 only
SUPPORTED
Linux
The one-liner bootstraps Node, Ollama, the model, and the CLI on a fresh box. NVIDIA, AMD (ROCm), and CPU fallback are detected.
SUPPORTED
macOS (Apple Silicon + Intel)
Metal GPU via Ollama on Apple Silicon; unified memory caps the tier at high. Intel runs CPU mode unless a supported GPU is present.
WSL2 ONLY
Windows
Native Windows is not supported. Install WSL2, open Ubuntu, and run the one-liner and every command inside it.