diff --git a/scripts/setup-spark.sh b/scripts/setup-spark.sh index 9ab3ed80a11..2cbcf6e556b 100755 --- a/scripts/setup-spark.sh +++ b/scripts/setup-spark.sh @@ -138,5 +138,3 @@ fi echo "" info "DGX Spark Docker configuration complete." info "" -info "Next step: run 'nemoclaw onboard' to set up your sandbox." -info " nemoclaw onboard" diff --git a/spark-install.md b/spark-install.md index 1eeb1187e84..7974cba0418 100644 --- a/spark-install.md +++ b/spark-install.md @@ -2,19 +2,32 @@ > **WIP** — This page is actively being updated as we work through Spark installs. Expect changes. +## Prerequisites + +- **Docker** (pre-installed, v28.x) +- **Node.js 22** (installed by the install.sh) +- **OpenShell CLI** (installed via the Quick Start steps below) +- **NVIDIA API Key** from [build.nvidia.com](https://build.nvidia.com) — prompted on first run + ## Quick Start ```bash -# Clone and install +# Install OpenShell: +curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh + +# Clone NemoClaw: git clone https://github.com/NVIDIA/NemoClaw.git cd NemoClaw -sudo npm install -g . -# Spark-specific setup (configures Docker for cgroup v2, then runs normal setup) -nemoclaw setup-spark -``` +# Spark-specific setup +sudo ./scripts/setup-spark.sh -That's it. `setup-spark` handles everything below automatically. +# Install NemoClaw using the NemoClaw/install.sh: +./install.sh + +# Alternatively, you can use the hosted install script: +curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash +``` ## What's Different on Spark @@ -42,28 +55,6 @@ Failed to start ContainerManager: failed to initialize top level QOS containers **Fix**: `setup-spark` sets `"default-cgroupns-mode": "host"` in `/etc/docker/daemon.json` and restarts Docker. This makes all containers use the host cgroup namespace, which is what k3s needs. -## Prerequisites - -These should already be on your Spark: - -- **Docker** (pre-installed, v28.x) -- **Node.js 22** — if not installed: - - ```bash - curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - - sudo apt-get install -y nodejs - ``` - -- **OpenShell CLI**: - - ```bash - ARCH=$(uname -m) # aarch64 on Spark - curl -fsSL "https://github.com/NVIDIA/OpenShell/releases/latest/download/openshell-linux-${ARCH}" -o /usr/local/bin/openshell - chmod +x /usr/local/bin/openshell - ``` - -- **NVIDIA API Key** from [build.nvidia.com](https://build.nvidia.com) — prompted on first run - ## Manual Setup (if setup-spark doesn't work) ### Fix Docker cgroup namespace