{"record":{"id":"dd88e71860592160","repo":"DioxusLabs/dioxus","slug":"linuxdeploy-not-found-and-automatic-downloads-are","errorCode":null,"errorMessage":"linuxdeploy not found and automatic downloads are disabled. Install linuxdeploy manually.","messagePattern":"linuxdeploy not found and automatic downloads are disabled\\. Install linuxdeploy manually\\.","errorType":"exception","errorClass":"anyhow::Error","httpStatus":null,"severity":"error","filePath":"packages/cli/src/bundler/tools.rs","lineNumber":179,"sourceCode":"        bail!(\n            \"WiX extraction succeeded but candle.exe not found at {}\",\n            candle.display()\n        );\n    }\n\n    Ok(wix_dir)\n}\n\nasync fn ensure_linuxdeploy(tools_dir: &Path, arch: &str) -> Result<PathBuf> {\n    let linuxdeploy_name = format!(\"linuxdeploy-{arch}.AppImage\");\n    let linuxdeploy_path = tools_dir.join(&linuxdeploy_name);\n\n    if linuxdeploy_path.exists() {\n        return Ok(linuxdeploy_path);\n    }\n\n    if CliSettings::prefer_no_downloads() {\n        bail!(\n            \"linuxdeploy not found and automatic downloads are disabled. Install linuxdeploy manually.\"\n        );\n    }\n\n    let url = format!(\"{LINUXDEPLOY_URL_BASE}/{linuxdeploy_name}\");\n    tracing::info!(\"Downloading linuxdeploy from {url}...\");\n\n    let data = download_bytes(&url).await?;\n    std::fs::create_dir_all(tools_dir)?;\n    std::fs::write(&linuxdeploy_path, &data)?;\n\n    #[cfg(unix)]\n    std::fs::set_permissions(&linuxdeploy_path, std::fs::Permissions::from_mode(0o755))?;\n\n    Ok(linuxdeploy_path)\n}\n\nasync fn download_webview2_bootstrapper(tools_dir: &Path) -> Result<PathBuf> {","sourceCodeStart":161,"sourceCodeEnd":197,"githubUrl":"https://github.com/DioxusLabs/dioxus/blob/24f6a829df0dfa203961a98ea4cae21c2ff27e28/packages/cli/src/bundler/tools.rs#L161-L197","documentation":"ensure_linuxdeploy could not find the arch-specific linuxdeploy AppImage in the tools cache and automatic downloads are disabled. linuxdeploy is required for AppImage packaging, so the bundler bails asking for a manual install.","triggerScenarios":"Thrown at packages/cli/src/bundler/tools.rs:179 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Install linuxdeploy manually, or enable automatic tool downloads in the dx settings."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"24f6a829df0dfa203961a98ea4cae21c2ff27e28","analyzedAt":"2026-08-23T07:10:14.078Z","contentChangedAt":"2026-08-23T07:10:14.078Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}