feat(installer): support DGX OS 7.6 on Station

[senthilr-nv]

Summary

Recognize stock DGX OS 7.6.x as a stable DGX Station GB300 release family instead of requiring --force-station-install for each build. The existing hardware and runtime gates remain unchanged, future release families remain fail-closed, and package-preserving factory profiles now tolerate an idle PackageKit daemon observed on the physical 7.6 image.

Related Issue

Fixes #7417

Changes

• Add a stock DGX OS version-family helper for reviewed 7.2.0, 7.4.0, 7.5.0, and numeric 7.6.x releases. The Station classifier consumes it because exact build dates and point-release tuples cannot represent the observed 7.6 release family; classifier tests cover OTA, no-OTA, malformed, future, and wrong-lineage cases.
• Recognize the observed no-OTA 7.6 marker only when DGX_PRETTY_NAME, DGX_SWBUILD_VERSION, DGX_SWBUILD_DATE, and DGX_PLATFORM establish the workstation release lineage. Driver, ECC, Docker, CDI, container GPU visibility, and exactly-one-GB300 checks still gate preparation.
• Allow an idle packagekitd only on stock DGX OS and AI Developer Tools profiles that preserve factory packages. Generic Ubuntu still quiesces PackageKit before package mutation, BaseOS remains process-gated, and all real APT/dpkg activity remains blocked.
• Update the Station preparation and generated support documentation. The docs record the physical 7.6 read-only preflight while explicitly leaving full Station Express end-to-end qualification pending.

Type of Change

• Code change (feature, bug fix, or refactor)
• Code change with doc updates
• Doc only (prose changes, no code sample modifications)
• Doc only (includes code sample changes)

Quality Gates

• Tests added or updated for changed behavior
• Existing tests cover changed behavior — justification:
• Tests not applicable — justification:
• Docs updated for user-facing behavior changes
• Docs not applicable — justification:
• Sensitive paths changed (security, policy, credentials, preflight, onboarding, inference, runner, sandbox, or messaging)
• Sensitive-path review completed or maintainer-approved waiver recorded — reviewer/approval link/justification: Maintainer review is pending on this draft.
• Non-success, skipped, or missing CI check accepted by maintainer — check name, approval link, and follow-up issue:

Documentation Writer Review

• Documentation writer subagent reviewed the completed changes
• Result: blocked — documentation wording is complete, but canonical publication remains blocked until a maintainer accepts issue Support DGX OS 7.6.x in DGX Station Express #7417's product scope.
• Evidence: ci/platform-matrix.json, docs/get-started/dgx-station-preparation.mdx, docs/get-started/prerequisites.mdx, docs/inference/choose-inference-provider.mdx, and docs/reference/platform-support.mdx
• Agent: Codex Desktop
• PR: feat(installer): support DGX OS 7.6 on Station #7419

DGX Station Hardware Evidence

• Tested on DGX Station
• Tested commit: ddfd4857e55f2b564dc93587a48cc78cf413bf12
• Station profile/scenario: Physical DGX Station GB300; Ubuntu 24.04.4 ARM64; stock DGX OS 7.6.0; SMBIOS DGX_Station_GB300; one GB300 plus one auxiliary RTX PRO 6000; fresh login without Docker-group membership.
• Result: Exact committed helper classified supported-dgx-os. Passwordless-sudo --check made no persistent changes and returned CHECK_RESULT=READY_FOR_FACTORY_RUNTIME_PREPARATION; GB300 driver 610.43.03, ECC 0/0, zero containers, no inference workload, and failed units none. Full Station Express end-to-end qualification remains pending.
• Supporting evidence: Support DGX OS 7.6.x in DGX Station Express #7417 (comment)

Verification

• PR description includes a Signed-off-by: line and every commit appears as Verified in GitHub
• Normal pre-commit, commit-msg, and pre-push hooks passed, or npm run check:diff passed when hooks were skipped or unavailable
• Targeted behavior tests pass for the current change set, or tests are marked not applicable above — seven Station installer suites: 273 passed, 1 intentional skip; final wording/assertion rerun across three affected suites: 116 passed, 1 intentional skip
• Applicable broad gate passed — npm test for broad runtime/test-harness changes; npm run check for repo-wide validation/coverage changes — not applicable to this focused classifier/preflight compatibility change; repository structural checks passed
• Quality Gates section completed with required justifications or waivers
• No secrets, API keys, or credentials committed
• npm run docs builds without warnings (doc changes only) — equivalent generation, route, variant, and Fern checks passed with zero errors; Fern reported two existing environment/style warnings
• Doc pages follow the style guide (doc changes only)
• New doc pages include SPDX header and frontmatter (new pages only)

---

Signed-off-by: Senthil Ravichandran senthilr@nvidia.com

Summary by CodeRabbit

• Platform Support
  • Added support recognition for stock DGX OS 7.6.x on DGX Station GB300 with stricter no-OTA validation rules.
  • Clarified Station Express qualification status for the 7.6.x family and improved unsupported-OS boundary messaging.
  • Refined PackageKit/package-manager gating based on host profile to prevent installs/validation during active transactions.
• Inference Providers
  • Updated Local vLLM (managed install/start) guidance for default availability, model selections, and NGC login requirements.
• Documentation
  • Updated prerequisites and platform-support matrices plus DGX Station preparation details for 7.6.x.
• Tests
  • Expanded classification and package-state coverage for 7.6.x scenarios.

[copy-pr-bot]

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

📝 Walkthrough

Walkthrough

Station Express now recognizes qualifying no-OTA DGX OS 7.6.x DGX Station releases, updates PackageKit gating, expands classification tests, and revises DGX Station and managed-vLLM documentation.

Changes

DGX Station 7.6.x support

Layer / File(s)	Summary
Release classification and preflight gating scripts/prepare-dgx-station-host.sh, scripts/install.sh	Adds supported-version detection for qualifying no-OTA DGX OS 7.6.x releases, refines PackageKit transaction checks by host profile, and updates boundary messaging.
Classification and preflight test coverage test/install-express-prompt.test.ts, test/install-station-dgx-os.test.ts, test/install-station-package-state.test.ts	Adds 7.6.x fixtures and classification cases, fail-closed metadata coverage, updated guidance assertions, and host-profile-specific PackageKit tests.
Qualification documentation and support matrices docs/get-started/dgx-station-preparation.mdx, docs/get-started/prerequisites.mdx, docs/reference/platform-support.mdx, docs/inference/choose-inference-provider.mdx, ci/platform-matrix.json, test/station-doc-ownership.test.ts	Documents 7.6.x metadata requirements, pending qualification status, preflight behavior, platform support details, and managed-vLLM availability requirements.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant StationExpress
  participant ReleaseClassifier
  participant PackageStateCheck
  StationExpress->>ReleaseClassifier: inspect DGX OS release metadata
  ReleaseClassifier-->>StationExpress: return supported-dgx-os or unsupported-dgx-os
  StationExpress->>PackageStateCheck: validate package-manager state
  PackageStateCheck-->>StationExpress: allow factory-preserving profile or reject active PackageKit state

Loading

Suggested labels: feature

Suggested reviewers: ericksoa, apurvvkumaria, sandl99

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly names the installer feature and the DGX OS 7.6 Station support being added.
Linked Issues check	✅ Passed	The PR recognizes stock DGX OS 7.6.x on DGX Station GB300, keeps fail-closed checks, and adds matching docs/tests.
Out of Scope Changes check	✅ Passed	The changed docs, tests, scripts, and metadata all support the DGX OS 7.6 Station work with no unrelated scope visible.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

PR Review Advisor — Informational

Advisor assessment: Informational / medium confidence
Next action: No advisor follow-up needed.
Findings: 0 blockers · 0 warnings · 0 suggestions
Status: No actionable findings remain in the canonical review ledger.

Model lanes

• GPT-5.6 Terra (primary): Completed · medium confidence · 0 blockers · 0 warnings · 0 suggestions
• Nemotron 3 Ultra (second opinion): Completed · high confidence · 0 blockers · 0 warnings · 0 suggestions
• Model comparison: normalized findings match; normalized E2E selections differ; severity counts match.

Nemotron output stays in workflow artifacts and does not change the assessment above.

E2E guidance

Advisory only. E2E / PR Gate selects and runs jobs independently.

Recommended E2E: cloud-onboard

Workflow run details

This automated review informs maintainers. Warnings and suggestions do not require a response. A maintainer decides whether to merge.

[senthilr-nv]

Physical DGX Station evidence for review: the committed Station preparation helper at ddfd4857e was exercised read-only on a physical DGX Station GB300 running stock DGX OS 7.6.0. SMBIOS reported DGX_Station_GB300; the helper classified supported-dgx-os / stock-dgx-os, selected the single GB300 (10de:31c3) for inference, treated the RTX PRO GPU as auxiliary, validated driver 610.43.03, corrected/uncorrected ECC 0/0, Docker, Buildx, NVIDIA Container Toolkit, and CDI, and completed with CHECK_RESULT=READY_FOR_FACTORY_RUNTIME_PREPARATION. The check made no persistent host changes. Full command and output evidence: #7417 (comment). This satisfies the physical Station evidence requirement for the preparation-script change; full Station Express E2E remains separate release qualification.

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@scripts/prepare-dgx-station-host.sh`:
- Around line 261-264: Update the no-OTA branch around
dgx_station_release_schema_is_valid to reject any present DGX_OTA_* metadata,
not only DGX_OTA_DATE, before continuing to DGX_PRETTY_NAME and version parsing.
Preserve the existing return behavior for valid no-OTA metadata, and add a
regression fixture covering a partial OTA marker such as DGX_OTA_PRETTY_NAME
alone.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 8a30c54a-3cf8-4779-a0a6-4eae1c42028b

📥 Commits

Reviewing files that changed from the base of the PR and between d13e34a and 244b1d9.

📒 Files selected for processing (11)

• ci/platform-matrix.json
• docs/get-started/dgx-station-preparation.mdx
• docs/get-started/prerequisites.mdx
• docs/inference/choose-inference-provider.mdx
• docs/reference/platform-support.mdx
• scripts/install.sh
• scripts/prepare-dgx-station-host.sh
• test/install-express-prompt.test.ts
• test/install-station-dgx-os.test.ts
• test/install-station-package-state.test.ts
• test/station-doc-ownership.test.ts

[senthilr-nv]

PR #7419 is synchronized with main at d42f73609; final head is dc8c18efc.

Changes:

• c11826290 keeps OTA-form DGX OS releases limited to the previously reviewed 7.2.0, 7.4.0, and 7.5.0 markers. DGX OS 7.6.x is accepted only through the issue-approved no-OTA workstation profile with DGX_PRETTY_NAME="NVIDIA DGX GB300WS".
• 2402c20c8 rejects partial DGX_OTA_* metadata and fails closed on active, malformed, or unqueryable PackageKit transactions before factory-runtime validation.
• 00e56255d makes the OTA/no-OTA boundary explicit in installer output and canonical/generated docs.
• 8fdc6a0e2 proves complete OTA history cannot enter the no-OTA 7.6.x path.
• 5980cecb5 resolves the MDX source-line review comment at the authoritative platform-matrix source.
• 3740ad8f9 covers malformed and inconsistent zero-count PackageKit replies for both factory-preserving profiles and proves failure before factory validation.
• dc8c18efc is a signed, non-overlapping synchronization with current main.

Verification:

• Focused installer tests: 195 passed, 1 skipped.
• Full installer-integration: 422 passed, 2 skipped.
• Final synchronized DGX OS classifier and PackageKit tests: 119 passed.
• Station documentation ownership: 4 passed.
• Platform-generated docs check: passed and all files are synchronized.
• npm run docs: passed with 0 errors and 2 existing warnings.
• Normal pre-commit and pre-push hooks passed, including ShellCheck, repository checks, source-shape and test-size budgets, CLI type checking, and commit lint.
• All contributor commits, including both main-sync merges, are signed and GitHub Verified.

Physical read-only check of the final preparation-helper bytes:

commit=c118262907749514c0505bf37c8e9b2deea92dbc
final_head=dc8c18efc212541f04e551e0f0b483c3f23aae61
helper_diff=none
platform=DGX Station GB300
profile=stock-dgx-os
release=supported-dgx-os
os=Ubuntu 24.04.4 LTS
arch=aarch64
packagekit_transactions=none
package_manager=idle
factory_packages=preserved
state_preservation=pass
state_diff_bytes=0

The read-only check stopped at the expected existing-agent-workload guard because that Station runs OpenShell workloads. It did not stop containers or change host state. Evidence is preserved at station/e2e/results/global.prd.ga.launchpad.nvidia.com/20260723T152525Z-candidate-check-51319 in the private golden-path repository. The earlier full physical --check proof remains linked in #7417.

Review disposition:

• The partial-OTA classifier finding is fixed and acknowledged.
• The MDX source-line finding is fixed and acknowledged.
• The final PackageKit parser-test warning is fixed in 3740ad8f9; 37 focused package-state tests passed before the latest non-overlapping main sync.
• No actionable review finding remains. The final automated review execution had an advisor output-contract failure, and its canonical ledger requested no follow-up.
• Credential-bearing cloud-onboard was selected but did not receive fork code; a maintainer must approve the recorded fork E2E skip.

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/get-started/prerequisites.mdx`:
- Line 97: Reformat the DGX OS (Station) qualification text so each sentence
occupies its own MDX source line, moving the detailed prose outside the table if
needed while preserving the existing meaning and link.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: b8fa81e2-0c71-4475-abf3-0bcfb92ce2b1

📥 Commits

Reviewing files that changed from the base of the PR and between c118262 and 00e5625.

📒 Files selected for processing (8)

• ci/platform-matrix.json
• docs/get-started/dgx-station-preparation.mdx
• docs/get-started/prerequisites.mdx
• docs/inference/choose-inference-provider.mdx
• docs/reference/platform-support.mdx
• scripts/install.sh
• test/install-express-prompt.test.ts
• test/station-doc-ownership.test.ts

🚧 Files skipped from review as they are similar to previous changes (7)

• docs/inference/choose-inference-provider.mdx
• ci/platform-matrix.json
• docs/get-started/dgx-station-preparation.mdx
• test/station-doc-ownership.test.ts
• scripts/install.sh
• docs/reference/platform-support.mdx
• test/install-express-prompt.test.ts

[senthilr-nv]

Addressed the final advisor warning in 3740ad8f9. The PackageKit orchestration test now covers malformed and inconsistent zero-count replies for both stock-dgx-os and ai-developer-tools, and each case proves failure occurs before factory validation. Focused result: 37 tests passed.