{"record":{"id":"72166acbb48e6ad7","repo":"zed-industries/zed","slug":"failed-to-spawn-remote-server-72166a","errorCode":null,"errorMessage":"failed to spawn remote server","messagePattern":"failed to spawn remote server","errorType":"exception","errorClass":"anyhow::Error","httpStatus":null,"severity":"error","filePath":"crates/remote/src/transport/wsl.rs","lineNumber":470,"sourceCode":"\n        proxy_args.push(remote_binary_path.display(PathStyle::Unix).into_owned());\n        proxy_args.push(\"proxy\".to_owned());\n        proxy_args.push(\"--identifier\".to_owned());\n        proxy_args.push(unique_identifier);\n\n        if reconnect {\n            proxy_args.push(\"--reconnect\".to_owned());\n        }\n\n        let proxy_process =\n            match wsl_command_impl(&self.connection_options, \"env\", &proxy_args, true)\n                .kill_on_drop(true)\n                .spawn()\n            {\n                Ok(process) => process,\n                Err(error) => {\n                    return Task::ready(Err(\n                        anyhow::Error::new(error).context(\"failed to spawn remote server\")\n                    ));\n                }\n            };\n\n        super::handle_rpc_messages_over_child_process_stdio(\n            proxy_process,\n            incoming_tx,\n            outgoing_rx,\n            connection_activity_tx,\n            cx,\n        )\n    }\n\n    fn upload_directory(\n        &self,\n        src_path: PathBuf,\n        dest_path: RemotePathBuf,\n        cx: &App,","sourceCodeStart":452,"sourceCodeEnd":488,"githubUrl":"https://github.com/zed-industries/zed/blob/f4178619acd0d47ea1f76a2025c42962c6d6638c/crates/remote/src/transport/wsl.rs#L452-L488","documentation":"Fires in start_proxy when spawning the WSL `env ... proxy` process fails (wsl_command_impl spawn returned an OS error), so the remote server proxy could not be started over the WSL connection. Typically caused by a missing or non-executable remote binary, a broken WSL distribution, or the remote server binary not being downloaded/compatible.","triggerScenarios":"Thrown at crates/remote/src/transport/wsl.rs:470 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Verify the WSL distribution is installed and healthy (`wsl -l -v`, `wsl --update`)","Check that the remote server binary path exists and is executable inside the WSL filesystem","Retry the connection to re-download the remote server binary","Check disk space and permissions in the WSL distro"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"f4178619acd0d47ea1f76a2025c42962c6d6638c","analyzedAt":"2026-08-20T19:29:52.058Z","contentChangedAt":"2026-08-20T19:29:52.058Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}