Skip to content

[macOS][Onboard] Colima onboarding fails to start the gateway: Socket not found /var/run/docker.sock #12367

Open

Description

@bowenzhu21

Investigation Summary

Description

nemoclaw onboard fails at [2/8] Starting OpenShell gateway on macOS with Colima and DOCKER_HOST unset.

Expected: the gateway uses the Docker daemon that preflight found.

Reproduction Steps

  1. brew install colima docker && colima start --cpu 4 --memory 8
  2. Confirm DOCKER_HOST is unset, docker context show prints colima, and /var/run/docker.sock does not exist.
  3. Run nemoclaw onboard.

Environment

  • OS: macOS 26.6.2 (Apple M4)
  • Container runtime: Colima 0.10.3, Docker 29.5.2
  • Node.js: v22.23.3
  • OpenShell: 0.0.116
  • NemoClaw: main at 586438d93

Debug Output

  [1/8] Preflight checks
  ✓ Docker daemon: server 29.5.2
  ✓ Container runtime: colima

  [2/8] Starting OpenShell gateway
  Docker-driver gateway failed to start.
    Error:   × execution error: failed to create compute runtime: execution error: failed
      │ to create Docker client: Socket not found: /var/run/docker.sock
  Docker daemon is not running — cannot start the gateway.

Activity

  1. added
    area: networkingDNS, proxy, TLS, ports, host aliases, or connectivity
    area: onboardingOnboarding FSM, provider setup, sandbox launch, or first-run flow
    platform: macosAffects macOS, including Apple Silicon
    on Oct 3, 2026
  2. added theissue type on Oct 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area: networkingDNS, proxy, TLS, ports, host aliases, or connectivityarea: onboardingOnboarding FSM, provider setup, sandbox launch, or first-run flowplatform: macosAffects macOS, including Apple Silicon

    Type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions