Skip to content

[All Platforms][Docs] quickstart-hermes missing Docker prerequisite and headless CHAT_UI_URL guidance #4413

@mercl-lau

Description

@mercl-lau

Description

Automated doc validation (2026-05-28) on macOS Apple Silicon found two gaps in the quickstart-hermes documentation:

  1. Docker not listed as a prerequisite. The installer detects missing Docker and warns, but the quickstart-hermes page does not mention Docker. Users only discover the requirement after install fails at the onboard step.

  2. No headless/remote UI guidance. The installer warns about CHAT_UI_URL for headless hosts, but the doc does not cover this. Users accessing via SSH get no guidance.

Environment

Device:        Mac Studio (Apple Silicon)
OS:            macOS (arm64)
Docker:        NOT INSTALLED
NemoClaw:      CLI installed, onboard skipped
OpenClaw:      N/A (onboard did not complete)

Steps to Reproduce

  1. On a macOS machine WITHOUT Docker installed
  2. Follow quickstart-hermes: curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash
  3. CLI installs (32s), but onboard is skipped with Docker warning

Expected Result

  1. Page should list Docker (Docker Desktop or Colima) as a prerequisite
  2. Page should mention CHAT_UI_URL for headless/remote scenarios

Actual Result

[WARN] Install Docker: Docker is required before onboarding can create a gateway or sandbox.
[WARN] Review remote/headless UI settings: Set CHAT_UI_URL when remote browser access matters.
[WARN] Skipping onboarding until the host prerequisites above are fixed.

NVB#6234345

Metadata

Metadata

Assignees

Labels

NV QABugs found by the NVIDIA QA Teamarea: docsDocumentation, examples, guides, or docs buildv0.0.54Release target

Type

No fields configured for Bug.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions