DioxusLabs/dioxus · error · anyhow::Error

linuxdeploy not found and automatic downloads are disabled.

Error message

linuxdeploy not found and automatic downloads are disabled. Install linuxdeploy manually.

What it means

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.

Source

Thrown at packages/cli/src/bundler/tools.rs:179

        bail!(
            "WiX extraction succeeded but candle.exe not found at {}",
            candle.display()
        );
    }

    Ok(wix_dir)
}

async fn ensure_linuxdeploy(tools_dir: &Path, arch: &str) -> Result<PathBuf> {
    let linuxdeploy_name = format!("linuxdeploy-{arch}.AppImage");
    let linuxdeploy_path = tools_dir.join(&linuxdeploy_name);

    if linuxdeploy_path.exists() {
        return Ok(linuxdeploy_path);
    }

    if CliSettings::prefer_no_downloads() {
        bail!(
            "linuxdeploy not found and automatic downloads are disabled. Install linuxdeploy manually."
        );
    }

    let url = format!("{LINUXDEPLOY_URL_BASE}/{linuxdeploy_name}");
    tracing::info!("Downloading linuxdeploy from {url}...");

    let data = download_bytes(&url).await?;
    std::fs::create_dir_all(tools_dir)?;
    std::fs::write(&linuxdeploy_path, &data)?;

    #[cfg(unix)]
    std::fs::set_permissions(&linuxdeploy_path, std::fs::Permissions::from_mode(0o755))?;

    Ok(linuxdeploy_path)
}

async fn download_webview2_bootstrapper(tools_dir: &Path) -> Result<PathBuf> {

View on GitHub (pinned to 24f6a829df)

Solutions

1. Install linuxdeploy manually, or enable automatic tool downloads in the dx settings.

When it happens

Trigger: Thrown at packages/cli/src/bundler/tools.rs:179 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of DioxusLabs/dioxus@24f6a829df (2026-08-23). Data as JSON: /api/errors/dd88e71860592160. Report an issue: GitHub.