{"record":{"id":"77ebd39d7218e427","repo":"abiosoft/colima","slug":"error-setting-up-network-dependencies-w","errorCode":null,"errorMessage":"error setting up network dependencies: %w","messagePattern":"error setting up network dependencies: %w","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"environment/vm/lima/daemon.go","lineNumber":111,"sourceCode":"\t\t\tif !s.Running {\n\t\t\t\treturn fmt.Errorf(\"daemon is not running\")\n\t\t\t}\n\t\t\tfor _, p := range s.Processes {\n\t\t\t\tif !p.Running {\n\t\t\t\t\treturn p.Error\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn nil\n\t\t})\n\t}\n\n\t// network failure is not fatal\n\tif err := a.Exec(); err != nil {\n\t\tif useVmnet {\n\t\t\tfunc() {\n\t\t\t\tinstalled, _ := ctx.Value(networkInstalledKey).(bool)\n\t\t\t\tif !installed {\n\t\t\t\t\tlog.Warnln(fmt.Errorf(\"error setting up network dependencies: %w\", err))\n\t\t\t\t\treturn\n\t\t\t\t}\n\n\t\t\t\tstatus, ok := ctx.Value(statusKey).(daemon.Status)\n\t\t\t\tif !ok {\n\t\t\t\t\treturn\n\t\t\t\t}\n\t\t\t\tif !status.Running {\n\t\t\t\t\tlog.Warnln(fmt.Errorf(\"error starting network: %w\", err))\n\t\t\t\t\treturn\n\t\t\t\t}\n\n\t\t\t\tfor _, p := range status.Processes {\n\t\t\t\t\t// TODO: handle inotify separate from network\n\t\t\t\t\tif p.Name == inotify.Name {\n\t\t\t\t\t\tcontinue\n\t\t\t\t\t}\n\t\t\t\t\tif !p.Running {","sourceCodeStart":93,"sourceCodeEnd":129,"githubUrl":"https://github.com/abiosoft/colima/blob/c3a5f9184d83a197184f897a9f07eb3c01b3bc88/environment/vm/lima/daemon.go#L93-L129","documentation":"Logged as a warning (network failure is explicitly non-fatal for vmnet setup) when the daemon chain a.Exec() failed and the network dependency was never installed (ctx networkInstalledKey != true). It wraps the same chain error and signals that installing the vmnet/network dependencies (root daemon + vmnet networking) failed, so addressable networks will not work for this start.","triggerScenarios":"'colima start --network-address' (or networks: in config) where deps.Install for the network/vmnet daemon failed: sudo prompt/permission failure on the host for vde_vmnet/socket_vmnet, missing vmnet helpers, macOS refusing VM network entitlements, or the guest-side install failing; because installation never completed, the installed flag stays false and this branch warns instead of the more specific 'error starting network'.","commonSituations":"First use of --network-address on machines where socket_vmnet/vde_vmnet is absent or not sudo-runnable; colima installed via brew without the vmnet helpers; corporate sudo policies blocking the non-interactive install; macOS updates breaking vmnet entitlements.","solutions":["Ensure vmnet helpers exist and run: on brew installs 'brew install socket_vmnet' (colima bundles sudoers setup) and verify passwordless sudo for the helper per colima docs.","Retry with defaults first ('colima start') to confirm the VM itself is fine, then add --network-address back.","Run colima with verbose logging (COLIMA_LOG_LEVEL/debug or 'colima start -v') to surface the underlying install error from the wrapped err.","If sudo is the blocker, run once from an interactive sudo-capable shell so the installer can set up the vmnet daemon.","Recreate the VM if partial network state lingers: 'colima delete -f && colima start --network-address'."],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":"// verify vmnet helper availability before enabling addressable networks\nif conf.Network.Address {\n    if _, err := exec.LookPath(\"vde_vmnet\"); err != nil {\n        if _, err := exec.LookPath(\"socket_vmnet\"); err != nil {\n            return fmt.Errorf(\"vmnet helpers not installed; brew install socket_vmnet\")\n        }\n    }\n}","typeGuard":null,"tryCatchPattern":"// daemon.go already degrades to a warning; mirror that in callers\nif err := a.Exec(); err != nil {\n    if !installed {\n        log.Warnln(fmt.Errorf(\"error setting up network dependencies: %w\", err)) // continue start\n    }\n}","preventionTips":["Install socket_vmnet/vde_vmnet and colima's sudoers config before first --network-address use.","Run the first privileged setup from an interactive sudo-capable shell.","Test with default networking first, then layer on addressable networks."],"tags":["network","vmnet","daemon","non-fatal","permissions"],"backgroundTag":null,"analyzedSha":"c3a5f9184d83a197184f897a9f07eb3c01b3bc88","analyzedAt":"2026-08-15T18:58:08.334Z","schemaVersion":2},"datasetVersion":"2026-08-16T03:17:38.424Z"}