// Section 14.4 · Operate
The Command Surface
1 min14.4Operate
parallelix-node <command> [options]
setup Guided onboarding: hardware detect, Ollama check, model pull,
key gen, staking link, nodeId auto-detect, service install offer.
Idempotent: re-running resumes.
probe Detect hardware + Ollama; print the tier it maps to
init [--wallet 0x..] Generate the node key + config; print nodeKeyHash (--force overwrites)
models [pull <name>] List local Ollama models, or pull one
models catalog List the curated model catalog with VRAM requirements
models recommend Recommend the largest model fitting 90% of VRAM (50% RAM on CPU)
start [--node-id <id>] Run the daemon: attach, heartbeat (uptime), serve inference, return PoE
[--gpu|--cpu] [--model m] [--plain]
service [--node-id <id>] Install as a background service (systemd/launchd): 24/7, auto-restart
[--gpu|--cpu]
update Check for a new version, verify sha256, atomic swap; aborts on mismatch
verify Run diagnostics; print remediation hints
status Print local node state (address, nodeKeyHash, tier, contracts)
logs Tail the node log (~/.parallelix/node.log)
version Print the binary version
--node-id is optional on start and service once nodeId is saved
to config (by setup or manually). --plain on start forces line
output (no TTY dashboard); used automatically under systemd/pipes.
Each command is documented with synopsis, flags, what it does, and example output in the CLI Command Reference tutorial (Part XVII).