Skip to content

[Linux][Onboard] invalid DOCKER_HOST advisory omits its identifier from CLI output #8473

Description

@mercl-lau

Description

When onboarding is blocked by an unsupported DOCKER_HOST value, the CLI shows the advisory title and remediation but omits the advisory identifier. This prevents users and tooling from distinguishing the finding by its stable product identifier.

Platform scope: Reproduced on Ubuntu 24.04 and WSL2; macOS was not tested.

Regression: Unknown — earlier versions not tested.

Environment

Device:        Ubuntu test host
OS:            Ubuntu 24.04.4 LTS
Architecture:  x86_64
Node.js:       v22.23.1
npm:           10.9.8
Docker:        Docker version 29.5.3, build d1c06ef
OpenShell CLI: openshell 0.0.85
NemoClaw:      nemoclaw v0.0.103
OpenClaw:      N/A (onboarding blocked during preflight)

Steps to Reproduce

  1. On Ubuntu 24.04 with Docker running, unset any explicit Docker context:

    unset DOCKER_CONTEXT
  2. Set an unsupported Docker endpoint using a documentation-only address:

    export DOCKER_HOST=tcp://192.0.2.10:2375
  3. Run:

    nemoclaw onboard --fresh --name invalid-docker-host-test --non-interactive --yes --yes-i-accept-third-party-software
  4. Inspect the preflight advisory written to the terminal.

Expected Result

Onboarding exits nonzero. The advisory output includes the stable identifier invalid_docker_host, actionable commands to unset DOCKER_HOST or select an absolute Unix socket, and does not show docker_group_permission or start_docker findings.

Actual Result

Onboarding exits nonzero and shows the correct title and remediation, but invalid_docker_host is absent:

[1/8] Preflight checks
✗ Docker is not reachable. Please fix Docker and try again.

Suggested fix:
- Fix the DOCKER_HOST endpoint: DOCKER_HOST is set to an endpoint onboarding cannot use.
  unset DOCKER_HOST
  export DOCKER_HOST=unix:///var/run/docker.sock

Logs

[1/8] Preflight checks
✗ Docker is not reachable. Please fix Docker and try again.

Suggested fix:
- Fix the DOCKER_HOST endpoint: DOCKER_HOST is set to an endpoint onboarding cannot use. Onboarding supports only an absolute unix:// Docker socket. TCP and SSH endpoints and relative paths are not supported, even when reachable.
  unset DOCKER_HOST
  export DOCKER_HOST=unix:///var/run/docker.sock

Metadata

Metadata

Assignees

Labels

NV QABugs found by the NVIDIA QA Teamneeds: triageAwaiting maintainer classification

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions