{"record":{"id":"652da06160670af0","repo":"wasmerio/wasmer","slug":"this-cli-does-not-support-the-connect-command-o","errorCode":null,"errorMessage":"This CLI does not support the 'connect' command: only available on Linux (feature: tun-tap)","messagePattern":"This CLI does not support the 'connect' command: only available on Linux \\(feature: tun-tap\\)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"lib/cli/src/commands/connect.rs","lineNumber":105,"sourceCode":"    //            AppId::from_ip(&cidr.ip, NetworkIdEncodingMethod::PrivateProjection)\n    //        {\n    //            let ip = app_id.into_ip(\n    //                cidr.ip,\n    //                0x00_1001,\n    //                NetworkIdEncodingMethod::PrivateProjection,\n    //            );\n    //            println!(\"Instance: {}/{}\", ip, cidr.prefix);\n    //        }\n    //    }\n    //    println!(\"Press ctrl-c to terminate\");\n    //    socket.await?;\n\n    //    Ok(())\n    //}\n\n    //#[cfg(not(all(target_os = \"linux\", feature = \"tun-tap\")))]\n    async fn run_async(self) -> Result<(), anyhow::Error> {\n        Err(anyhow::anyhow!(\n            \"This CLI does not support the 'connect' command: only available on Linux (feature: tun-tap)\"\n        ))\n    }\n}\n","sourceCodeStart":87,"sourceCodeEnd":110,"githubUrl":"https://github.com/wasmerio/wasmer/blob/8c4b9ee9d33fb2068863fbb3d328683e7e6ff7f5/lib/cli/src/commands/connect.rs#L87-L110","documentation":"The `wasmer connect` command (VPN/TUN-TAP networking) is only implemented for Linux when the `tun-tap` cargo feature is enabled. This unconditional error is the fallback `run_async` implementation compiled on all other platforms/feature configurations, so invoking `connect` there always fails with this message.","triggerScenarios":"Running `wasmer connect` on a non-Linux OS (macOS, Windows), or on a Linux build of the wasmer CLI that was compiled without the `tun-tap` feature enabled.","commonSituations":"User reads docs describing the VPN `connect` feature and tries it on macOS/Windows; a distro/CI-installed wasmer binary built without tun-tap support; feature flags stripped in a release build.","solutions":["Run the command on Linux only; there is no cross-platform implementation.","Install/build a wasmer CLI with the tun-tap feature: build with the appropriate feature flags enabled for Linux.","Use an alternative networking mechanism (e.g. manual TUN setup or the platform-specific tooling) if you cannot rebuild."],"exampleFix":"// before (macOS or feature-less build)\nwasmer connect  // unsupported\n// after (Linux, feature-enabled build)\ncargo install wasmer-cli --features tun-tap\nwasmer connect","handlingStrategy":"type-guard","validationCode":"fn connect_supported() -> bool {\n    cfg!(all(target_os = \"linux\", feature = \"tun-tap\"))\n}\nif !connect_supported() {\n    eprintln!(\"connect requires Linux with the tun-tap feature; skipping\");\n}","typeGuard":"fn is_linux_with_tuntap() -> bool {\n    cfg!(target_os = \"linux\") && cfg!(feature = \"tun-tap\")\n}","tryCatchPattern":"match connect_cmd.run_async().await {\n    Err(e) if e.to_string().contains(\"does not support the 'connect' command\") => {\n        eprintln!(\"Platform/feature unsupported; use a Linux tun-tap build\");\n    }\n    other => other?,\n}","preventionTips":["Gate connect usage behind cfg!(target_os = \"linux\") checks in scripts.","Confirm the installed CLI was built with the tun-tap feature before relying on connect.","Document platform restrictions for teams deploying across OSes."],"tags":["cli","unsupported-platform","feature-flag","linux"],"backgroundTag":"unsupported-platform-feature","analyzedSha":"8c4b9ee9d33fb2068863fbb3d328683e7e6ff7f5","analyzedAt":"2026-09-01T23:06:31.009Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-09T06:17:21.866Z"}