You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 0da802e
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: docs/get-started/prerequisites.mdx
+15-5Lines changed: 15 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -41,10 +41,13 @@ If the group change is not active in the current shell, the installer exits with
41
41
If you choose the native Linux Ollama install path, the onboard wizard also requires `zstd` for Ollama archive extraction.
42
42
The installer also requires `strings` from `binutils` to verify the OpenShell binary before it continues with OpenShell install work.
43
43
44
-
On a DGX Station GB300 running the generic Ubuntu 24.04 ARM64 image, accepting express install prepares the host with NVIDIA open driver `610.43.02`, Docker CE `29.6.1` with Buildx, and NVIDIA Container Toolkit `1.19.1`.
45
-
DGX OS, NVIDIA BaseOS images, and other Station generations are outside this automatic preparation boundary and stop before host preparation.
46
-
On those systems, set `NEMOCLAW_PROVIDER` or `NEMOCLAW_NO_EXPRESS=1` explicitly to continue without Station host automation.
47
-
The preparation probes package and runtime state first, reuses exact matches, and installs only missing pinned packages, including the NVIDIA Container Toolkit libraries and `nvidia-ctk` CLI.
44
+
DGX Station GB300 express install accepts either the generic Ubuntu 24.04 ARM64 image or stock DGX OS `7.2.0`, `7.4.0`, or `7.5.0`.
45
+
A stock DGX OS image qualifies only when a safe, root-owned `/etc/dgx-release` marker identifies `DGX Server for GALAXY-GB300`.
46
+
An unknown version, malformed or unsafe marker, NVIDIA BaseOS image, or other Station generation stops before host preparation.
47
+
On an unqualified system, set `NEMOCLAW_PROVIDER` or `NEMOCLAW_NO_EXPRESS=1` explicitly to continue without Station host automation.
48
+
49
+
On the generic Ubuntu path, accepting express install prepares the host with NVIDIA open driver `610.43.02`, Docker CE `29.6.1` with Buildx, and NVIDIA Container Toolkit `1.19.1`.
50
+
Preparation probes package and runtime state first, reuses exact matches, and installs only missing pinned packages, including the NVIDIA Container Toolkit libraries and `nvidia-ctk` CLI.
48
51
It permits only the reviewed factory transition from `dkms``3.0.11-1ubuntu13` to `1:3.4.0-1ubuntu1`.
49
52
After reboot, preparation enables NVIDIA's packaged CDI refresh path and service, requires the `nvidia.com/gpu=all` device, and verifies it with a real container launch.
50
53
If the packaged refresh fails or does not produce that device, preparation prints service diagnostics and stops for administrator repair.
@@ -59,9 +62,16 @@ It does not install a host CUDA toolkit or Docker Compose.
59
62
If any other existing prerequisite version differs, preparation stops instead of changing it automatically.
60
63
After changing pinned packages, the installer exits with status `10`; reboot, sign in, and run the printed command, which pins the exact accepted NemoClaw commit before resuming express setup.
61
64
65
+
On a qualifying stock DGX OS image, express install validates the factory stack in place against the local default Docker daemon.
66
+
It requires a loaded GB300 driver with zero volatile corrected and uncorrected ECC errors, active Docker and containerd services, working Docker Buildx, `nvidia-ctk`, the `nvidia.com/gpu=all` CDI device, and successful `nvidia-smi` device-visibility probes through both CDI and `--gpus all`.
67
+
This path does not install or replace host packages, enable or restart services, generate CDI configuration, or rewrite the Docker runtime.
68
+
The preparation helper writes a private audit log under `~/station-bootstrap-logs`.
69
+
Aside from the installer's separately disclosed `docker`-group membership grant when the current trusted account needs Docker access, its only persistent stock-runtime effect is that the digest-pinned visibility-test image can remain in the Docker cache.
70
+
These probes establish local container GPU visibility; physical acceptance of the pinned managed-vLLM and Nemotron Ultra recipe remains a separate gate.
71
+
62
72
<Warningtitle="DGX Station Support Status">
63
73
DGX Station remains Deferred.
64
-
Full NemoClaw onboarding with this recipe has not completed end-to-end validation on physical DGX Station hardware.
74
+
Product validation of this express-install boundary on physical DGX Station hardware is still pending.
Copy file name to clipboardExpand all lines: docs/get-started/quickstart.mdx
+19-11Lines changed: 19 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -119,15 +119,19 @@ Use these details when your first-run path needs more control.
119
119
If the installer adds you to the `docker` group, run the printed `newgrp docker` command before you rerun it.
120
120
On macOS, start Docker Desktop or Colima first.
121
121
122
-
DGX Spark, Station GB300 hosts running the generic Ubuntu 24.04 ARM64 image, and Windows WSL offer an interactive express-install path that chooses a managed local inference option for the platform.
123
-
On that Station configuration, accepting the express prompt selects the pinned `nemotron-3-ultra-550b-a55b` managed-vLLM recipe and completes onboarding without more provider, model, policy, or sandbox-name choices.
124
-
DGX OS, NVIDIA BaseOS images, and other Station generations stop before host preparation.
122
+
DGX Spark, qualifying Station GB300 hosts, and Windows WSL offer an interactive express-install path that chooses a managed local inference option for the platform.
123
+
Station accepts the generic Ubuntu 24.04 ARM64 image and stock DGX OS `7.2.0`, `7.4.0`, or `7.5.0` when a safe, root-owned `/etc/dgx-release` marker identifies `DGX Server for GALAXY-GB300`.
124
+
Accepting the Station prompt selects the pinned `nemotron-3-ultra-550b-a55b` managed-vLLM recipe and completes onboarding without more provider, model, policy, or sandbox-name choices.
125
+
Unknown DGX OS versions, malformed or unsafe release markers, NVIDIA BaseOS images, and other Station generations stop before host preparation.
125
126
Set `NEMOCLAW_PROVIDER` or `NEMOCLAW_NO_EXPRESS=1` explicitly to continue on an unqualified Station without host automation.
126
-
It probes the pinned driver, Docker, Buildx, and NVIDIA Container Toolkit versions, reuses exact matches, installs missing pins, and permits only the reviewed factory `dkms` transition.
127
+
On generic Ubuntu, host preparation probes the pinned driver, Docker, Buildx, and NVIDIA Container Toolkit versions, reuses exact matches, installs missing pins, and permits only the reviewed factory `dkms` transition.
127
128
It establishes NVIDIA CDI through the packaged refresh service, then proves both CDI and `--gpus all` with real container launches.
128
129
If the packaged refresh fails or does not advertise `nvidia.com/gpu=all`, preparation prints service diagnostics and stops for administrator repair instead of generating CDI configuration directly.
129
130
After it changes pinned packages, the installer exits with status `10` at the required reboot boundary; reboot, sign in, and run the printed exact-commit command to resume the accepted recipe without another prompt.
130
-
This automation does not change Station's Deferred support status; physical end-to-end validation remains open.
131
+
On stock DGX OS, the installer instead validates the existing GB300 driver and volatile ECC state, local Docker and Buildx, `nvidia-ctk` and CDI, and `nvidia-smi` device visibility through both GPU container launch paths.
132
+
It does not install or replace host packages, enable or restart services, or rewrite the Docker runtime; aside from the private preparation log and separately disclosed `docker`-group membership grant when needed, only the digest-pinned visibility-test image can remain cached.
133
+
The visibility probes do not replace physical acceptance of the pinned managed-vLLM and Nemotron Ultra recipe.
134
+
This automation does not change Station's Deferred support status; product validation on physical DGX Station hardware remains pending.
131
135
Pass `--station-deepseek` to use DeepSeek V4 Flash for a Station demo instead.
132
136
The flag selects the interactive express prompt and requires terminal access.
133
137
Refer to [Platform Support](../reference/platform-support) and [Choose an Inference Provider](../inference/learn-and-choose/choose-inference-provider) for the current platform behavior.
@@ -194,19 +198,23 @@ Use these details when your first-run path needs more control.
On DGX Spark, Station GB300 hosts running the generic Ubuntu 24.04 ARM64 image, and Windows WSL, interactive installation offers express install after you accept the third-party software notice.
201
+
On DGX Spark, qualifying Station GB300 hosts, and Windows WSL, interactive installation offers express install after you accept the third-party software notice.
198
202
After you confirm the interactive express prompt, the installer switches the remaining onboarding to non-interactive mode, allows `sudo` password prompts for required host changes, and selects the managed local inference path for that platform.
199
203
DGX Spark uses managed vLLM with `qwen3.6-35b-a3b-nvfp4` by default.
200
204
DGX Station express install explicitly selects `nemotron-3-ultra-550b-a55b` instead of the Station managed-vLLM profile default, `deepseek-v4-flash`, and discloses the approximately `352 GB` model download before confirmation.
201
-
Before onboarding, the Station path requires Station GB300 with the generic Ubuntu 24.04 ARM64 image and checks for NVIDIA open driver `610.43.02`, Docker CE `29.6.1` with Buildx, and NVIDIA Container Toolkit `1.19.1`.
202
-
DGX OS, NVIDIA BaseOS images, and other Station generations are outside this automatic preparation boundary.
205
+
Before onboarding, the Station path accepts either the generic Ubuntu 24.04 ARM64 image or stock DGX OS `7.2.0`, `7.4.0`, or `7.5.0` with a safe, root-owned `/etc/dgx-release` marker for `DGX Server for GALAXY-GB300`.
206
+
Unknown versions, malformed or unsafe release markers, NVIDIA BaseOS images, and other Station generations are outside the automatic preparation boundary.
203
207
Set `NEMOCLAW_PROVIDER` or `NEMOCLAW_NO_EXPRESS=1` to continue without Station host automation.
204
-
Preparation reuses exact versions, installs missing pinned packages, permits only the reviewed `dkms` transition from `3.0.11-1ubuntu13` to `1:3.4.0-1ubuntu1`, and refuses every other mismatched version.
208
+
On generic Ubuntu, preparation checks for NVIDIA open driver `610.43.02`, Docker CE `29.6.1` with Buildx, and NVIDIA Container Toolkit `1.19.1`.
209
+
It reuses exact versions, installs missing pinned packages, permits only the reviewed `dkms` transition from `3.0.11-1ubuntu13` to `1:3.4.0-1ubuntu1`, and refuses every other mismatched version.
205
210
It requires the packaged NVIDIA CDI refresh service to advertise `nvidia.com/gpu=all`, and verifies CDI and `--gpus all` with real container launches.
206
211
If the packaged refresh fails or omits that device, preparation prints service diagnostics and stops for administrator repair instead of generating CDI configuration directly.
207
212
If NVIDIA Docker runtime registration or a post-change acceptance probe fails, preparation restores the prior Docker daemon configuration.
208
213
Changing pinned packages exits with status `10` for a reboot; after you sign in and run the printed exact-commit command, the accepted express recipe resumes without another prompt.
209
-
This automation does not change Station's Deferred support status; physical end-to-end validation remains open.
214
+
On stock DGX OS, the path instead validates the existing GB300 driver and zero-error volatile ECC state, local Docker and Buildx, `nvidia-ctk` and CDI, and `nvidia-smi` device visibility through both CDI and `--gpus all`.
215
+
It does not install or replace host packages, enable or restart services, generate CDI configuration, or rewrite the Docker runtime; aside from the private preparation log and separately disclosed `docker`-group membership grant when needed, only the digest-pinned visibility-test image can remain cached.
216
+
The visibility probes do not replace physical acceptance of the pinned managed-vLLM and Nemotron Ultra recipe.
217
+
This automation does not change Station's Deferred support status; product validation remains pending.
210
218
To select DeepSeek V4 Flash while retaining the one-confirmation Station express flow, run `curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash -s -- --station-deepseek`.
211
219
The `--station-deepseek` flag requires an interactive terminal; in a `curl | bash` pipeline, `/dev/tty` must be available.
212
220
Without terminal access, the installer stops before it installs Docker or build dependencies instead of ignoring the flag.
@@ -229,7 +237,7 @@ Use these details when your first-run path needs more control.
229
237
230
238
<Warning>
231
239
Express install automates the configuration but does not change DGX Station's Deferred support status.
232
-
Full NemoClaw onboarding with this recipe has not completed end-to-end validation on physical DGX Station hardware.
240
+
Product validation of this express-install boundary is still pending.
233
241
</Warning>
234
242
235
243
The installer auto-launches `nemoclaw onboard` when it can find the new binary.
if [ "${NEMOCLAW_NO_EXPRESS:-}"="1" ] || [ -n"${NEMOCLAW_PROVIDER:-}" ];thenreturn 0;fi
2961
-
error "DGX OS/BaseOS is outside the validated Station express boundary. Use the generic Ubuntu 24.04 ARM64 image."
2980
+
error "This DGX Station OS image is outside the validated Station express boundary. Use generic Ubuntu 24.04 ARM64 or stock DGX OS 7.2.0, 7.4.0, or 7.5.0 on Station GB300."
2962
2981
;;
2963
2982
"Unsupported DGX Station generation")
2964
2983
if [ "${NEMOCLAW_NO_EXPRESS:-}"="1" ] || [ -n"${NEMOCLAW_PROVIDER:-}" ];thenreturn 0;fi
info "Checking pinned DGX Station host prerequisites. Exact matches are reused."
3244
+
if [[ "$(classify_dgx_station_release)"=="supported-dgx-os" ]];then
3245
+
info "Validating stock DGX OS GPU device visibility and the local container runtime contract. Host packages and runtime configuration will not be changed."
3246
+
else
3247
+
info "Checking pinned DGX Station host prerequisites. Exact matches are reused."
3248
+
fi
3226
3249
local status=0
3227
3250
run_station_host_preparation || status=$?
3228
3251
case"$status"in
@@ -3250,6 +3273,10 @@ prepare_installer_host() {
3250
3273
# Intentional ordering: Station preparation owns the reboot boundary before
3251
3274
# generic Docker bootstrap; ensure_station_express_host is a no-op elsewhere.
3252
3275
ensure_station_express_host
3276
+
if [[ "${_SELECTED_EXPRESS_PLATFORM:-}"=="DGX Station" ]];then
inference_summary="managed local vLLM with NVIDIA Nemotron 3 Ultra 550B"
3288
3315
inference_disclosure="Managed vLLM pulls the pinned Station image and approximately 352 GB model, then runs a local inference container."
3289
3316
fi
3290
-
printf" Station host setup reuses exact prerequisite versions, applies the reviewed factory DKMS transition when present, installs missing pinned driver, Docker, and NVIDIA Container Toolkit packages, and may require one reboot.\n"
3317
+
if [[ "$(classify_dgx_station_release)"=="supported-dgx-os" ]];then
3318
+
printf" Stock DGX OS setup reuses the factory driver and container stack after local GPU device-visibility, CDI, Docker, and Buildx validation. It does not install or replace host packages or rewrite the Docker runtime.\n"
3319
+
else
3320
+
printf" Station host setup reuses exact prerequisite versions, applies the reviewed factory DKMS transition when present, installs missing pinned driver, Docker, and NVIDIA Container Toolkit packages, and may require one reboot.\n"
3321
+
fi
3291
3322
printf" Host setup may add this trusted local account to the docker group, which grants root-equivalent control. This flow is only for trusted single-user development hosts; shared or managed hosts require an organization-approved Docker access path.\n"
3292
3323
printf" DGX Station remains Deferred; this recipe has not completed end-to-end validation on physical hardware.\n"
0 commit comments