DioxusLabs/dioxus · error · anyhow::Error

WiX not found and automatic downloads are disabled. Install

Error message

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

What it means

ensure_wix could not find candle.exe in the tools cache and automatic downloads are disabled. WiX is required for MSI installers, so the bundler bails asking for a manual install instead of downloading.

Source

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

        );
    }

    #[cfg(unix)]
    let _ = std::fs::set_permissions(&makensis, std::fs::Permissions::from_mode(0o755));

    Ok(nsis_dir)
}

async fn ensure_wix(tools_dir: &Path) -> Result<PathBuf> {
    let wix_dir = tools_dir.join("wix314");
    let candle = wix_dir.join("candle.exe");

    if candle.exists() {
        return Ok(wix_dir);
    }

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

    tracing::info!("Downloading WiX toolset...");
    let data = download_and_verify(WIX_URL, WIX_SHA256, HashAlgo::Sha256).await?;

    std::fs::create_dir_all(&wix_dir)?;
    extract_zip(&data, &wix_dir)?;

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

    Ok(wix_dir)
}

View on GitHub (pinned to 24f6a829df)

Solutions

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

When it happens

Trigger: Thrown at packages/cli/src/bundler/tools.rs:151 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/ebf6c26795b508c0. Report an issue: GitHub.