{"id":"3ab6be90ea47e208","repo":"docker/cli","slug":"ssh-host-connection-is-not-valid-w","errorCode":null,"errorMessage":"ssh host connection is not valid: %w","messagePattern":"ssh host connection is not valid: %w","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cli/connhelper/connhelper.go","lineNumber":50,"sourceCode":"\n// GetConnectionHelperWithSSHOpts returns Docker-specific connection helper for\n// the given URL, and accepts additional options for ssh connections. It returns\n// nil without error when no helper is registered for the scheme.\n//\n// Requires Docker 18.09 or later on the remote host.\nfunc GetConnectionHelperWithSSHOpts(daemonURL string, sshFlags []string) (*ConnectionHelper, error) {\n\treturn getConnectionHelper(daemonURL, sshFlags)\n}\n\nfunc getConnectionHelper(daemonURL string, sshFlags []string) (*ConnectionHelper, error) {\n\tu, err := url.Parse(daemonURL)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\tif u.Scheme == \"ssh\" {\n\t\tsp, err := ssh.NewSpec(u)\n\t\tif err != nil {\n\t\t\treturn nil, fmt.Errorf(\"ssh host connection is not valid: %w\", err)\n\t\t}\n\t\tsshFlags = addSSHTimeout(sshFlags)\n\t\tsshFlags = disablePseudoTerminalAllocation(sshFlags)\n\n\t\tremoteCommand := []string{\"docker\", \"system\", \"dial-stdio\"}\n\t\tsocketPath := sp.Path\n\t\tif strings.Trim(sp.Path, \"/\") != \"\" {\n\t\t\tremoteCommand = []string{\"docker\", \"--host=unix://\" + socketPath, \"system\", \"dial-stdio\"}\n\t\t}\n\t\tsshArgs, err := sp.Command(sshFlags, remoteCommand...)\n\t\tif err != nil {\n\t\t\treturn nil, err\n\t\t}\n\t\treturn &ConnectionHelper{\n\t\t\tDialer: func(ctx context.Context, network, addr string) (net.Conn, error) {\n\t\t\t\treturn commandconn.New(ctx, \"ssh\", sshArgs...)\n\t\t\t},\n\t\t\tHost: \"http://docker.example.com\",","sourceCodeStart":32,"sourceCodeEnd":68,"githubUrl":"https://github.com/docker/cli/blob/e9452d6e785f6e365712b9d71bd7517591773c86/cli/connhelper/connhelper.go#L32-L68","documentation":"Error \"ssh host connection is not valid: %w\" thrown in docker/cli.","triggerScenarios":"Thrown at cli/connhelper/connhelper.go:50 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"analyzedSha":"e9452d6e785f6e365712b9d71bd7517591773c86","analyzedAt":"2026-08-01T07:09:22.474Z","schemaVersion":2}