Zephyr SDK install error in Windows: setup.cmd Toolchain download failed

cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 

Zephyr SDK install error in Windows: setup.cmd Toolchain download failed

Zephyr SDK install error in Windows: setup.cmd Toolchain download failed

Recently some Windows users started reporting issues installing the Zephyr SDK, required for building Zephyr applications.  Users first ran into this issue using NXP's MCUXpresso Installer, but had the same issue trying to manually install the Zephyr SDK.

The root cause is that setup.cmd and these other tools use wget to download the individual toolchain packages.  And apparently recent changes in Windows or security settings interpret this wget download as unsecure, and wget is blocked.

Context

The Zephyr SDK is a package of multiple toolchains that support all the hardware platforms and CPU architectures available in Zephyr.  The binary bundle releases for download are available in two options: Minimal and Full.  For example, these bundles can be downloaded here for v0.17.4, currently the latest release.

The Full bundle is a large download and includes all the toolchains and other tools in that download package.  The Minimal bundle is much smaller and does not contain any toolchains and allows users to choose the toolchains to download and install.  Minimal has an extra step after download to run the setup script and the user selects the tools to download.  In Windows, this script is setup.cmd.

If installing the Minimal bundle and wget downloads are blocked for setup.cmd, then the Zephyr SDK install fails.  MCUXpresso Installer v25.12 and other install options use the Minimal bundle, and can be blocked by this issue.

Workaround

NXP is working on improving the MCUXpresso Installer to address this issue.  But in the meantime, downloading and installing the Full bundle avoids using wget and avoids this issue.  

Download the Full bundle, here for v0.17.4, and extract the bundle in your user folder.  After extracting, the full Windows path will be C:\Users\<username>\zephyr-sdk-0.17.4.  West and other build tools will find this folder during the build.  The Zephyr SDK can also be installed elsewhere using an environment variable, see the Zephyr SDK documentation.  After extracting, run the setup.cmd to finish setup.  But with the Full install, setup.cmd will not need to download with wget.

Be aware, this article was written when v0.17.4 was the latest release of the Zephyr SDK.  Check here for the latest release.

Return to Zephyr Knowledge Hub

%3CLINGO-SUB%20id%3D%22lingo-sub-2304745%22%20slang%3D%22en-US%22%20mode%3D%22CREATE%22%3EZephyr%20SDK%20install%20error%20in%20Windows%3A%20setup.cmd%20Toolchain%20download%20failed%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-2304745%22%20slang%3D%22en-US%22%20mode%3D%22CREATE%22%3E%0A%3CP%3ERecently%20some%20Windows%20users%20started%20reporting%20issues%20installing%20the%20%3CA%20href%3D%22https%3A%2F%2Fdocs.zephyrproject.org%2Flatest%2Fdevelop%2Ftoolchains%2Fzephyr_sdk.html%22%20target%3D%22_self%22%20rel%3D%22nofollow%20noopener%20noreferrer%22%3EZephyr%20SDK%3C%2FA%3E%2C%20required%20for%20building%20Zephyr%20applications.%26nbsp%3B%20Users%20first%20ran%20into%20this%20issue%20using%20NXP's%20%3CA%20href%3D%22https%3A%2F%2Fwww.nxp.com%2Fdesign%2Fdesign-center%2Fsoftware%2Fdevelopment-software%2Fmcuxpresso-software-and-tools-%2Fmcuxpresso-installer%3AMCUXPRESSO-INSTALLER%22%20target%3D%22_self%22%20rel%3D%22nofollow%20noopener%20noreferrer%22%3EMCUXpresso%20Installer%3C%2FA%3E%2C%20but%20had%20the%20same%20issue%20trying%20to%20manually%20install%20the%20Zephyr%20SDK.%3C%2FP%3E%0A%3CP%3EThe%20root%20cause%20is%20that%20setup.cmd%20and%20these%20other%20tools%20use%20wget%20to%20download%20the%20individual%20toolchain%20packages.%26nbsp%3B%20And%20apparently%20recent%20changes%20in%20Windows%20or%20security%20settings%20interpret%20this%20wget%20download%20as%20unsecure%2C%20and%20wget%20is%20blocked.%3C%2FP%3E%0A%3CH1%20id%3D%22toc-hId-1325372978%22%20id%3D%22toc-hId-1325373008%22%3EContext%3C%2FH1%3E%0A%3CP%3EThe%20Zephyr%20SDK%20is%20a%20package%20of%20multiple%20toolchains%20that%20support%20all%20the%20hardware%20platforms%20and%20CPU%20architectures%20available%20in%20Zephyr.%26nbsp%3B%20The%20binary%20bundle%20releases%20for%20download%20are%20available%20in%20two%20options%3A%20Minimal%20and%20Full.%26nbsp%3B%20For%20example%2C%20these%20bundles%20can%20be%20downloaded%20here%20for%20%3CA%20href%3D%22https%3A%2F%2Fgithub.com%2Fzephyrproject-rtos%2Fsdk-ng%2Freleases%2Ftag%2Fv0.17.4%22%20target%3D%22_self%22%20rel%3D%22nofollow%20noopener%20noreferrer%22%3Ev0.17.4%3C%2FA%3E%2C%20currently%20the%20latest%20release.%3C%2FP%3E%0A%3CP%3EThe%20Full%20bundle%20is%20a%20large%20download%20and%20includes%20all%20the%20toolchains%20and%20other%20tools%20in%20that%20download%20package.%26nbsp%3B%20The%26nbsp%3B%3CSPAN%3EMinimal%20bundle%20is%20much%20smaller%20and%20does%20not%20contain%20any%20toolchains%20and%20allows%20users%20to%20choose%20the%20toolchains%20to%20download%20and%20install.%26nbsp%3B%20Minimal%20has%20an%20extra%20step%20after%20download%20to%20run%20the%20setup%20script%20and%20the%20user%20selects%20the%20tools%20to%20download.%26nbsp%3B%20In%20Windows%2C%20this%20script%20is%20setup.cmd.%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%3CSPAN%3EIf%20installing%20the%20Minimal%20bundle%20and%20wget%20downloads%20are%20blocked%20for%20setup.cmd%2C%20then%20the%20Zephyr%20SDK%20install%20fails.%26nbsp%3B%20MCUXpresso%20Installer%20v25.12%20and%20other%20install%20options%20use%20the%20Minimal%20bundle%2C%20and%20can%20be%20blocked%20by%20this%20issue.%3C%2FSPAN%3E%3C%2FP%3E%0A%3CH1%20id%3D%22toc-hId--482081485%22%20id%3D%22toc-hId--482081455%22%3E%3CSPAN%3EWorkaround%3C%2FSPAN%3E%3C%2FH1%3E%0A%3CP%3E%3CSPAN%3ENXP%20is%20working%20on%20improving%20the%20MCUXpresso%20Installer%20to%20address%20this%20issue.%26nbsp%3B%20But%20in%20the%20meantime%2C%20downloading%20and%20installing%20the%20Full%20bundle%20avoids%20using%20wget%20and%20avoids%20this%20issue.%26nbsp%3B%26nbsp%3B%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%3CSPAN%3EDownload%20the%20Full%20bundle%2C%20here%20for%20%3CA%20href%3D%22https%3A%2F%2Fgithub.com%2Fzephyrproject-rtos%2Fsdk-ng%2Freleases%2Ftag%2Fv0.17.4%22%20target%3D%22_self%22%20rel%3D%22nofollow%20noopener%20noreferrer%22%3Ev0.17.4%3C%2FA%3E%2C%20and%20extract%20the%20bundle%20in%20your%20user%20folder.%26nbsp%3B%20After%20extracting%2C%20the%20full%20Windows%20path%20will%20be%26nbsp%3B%3CCODE%3EC%3A%5CUsers%5C%3CUSERNAME%3E%5Czephyr-sdk-0.17.4%3C%2FUSERNAME%3E%3C%2FCODE%3E.%26nbsp%3B%20West%20and%20other%20build%20tools%20will%20find%20this%20folder%20during%20the%20build.%26nbsp%3B%20The%20Zephyr%20SDK%20can%20also%20be%20installed%20elsewhere%20using%20an%20environment%20variable%2C%20see%20the%20%3CA%20href%3D%22https%3A%2F%2Fdocs.zephyrproject.org%2Flatest%2Fdevelop%2Ftoolchains%2Fzephyr_sdk.html%22%20target%3D%22_self%22%20rel%3D%22nofollow%20noopener%20noreferrer%22%3EZephyr%20SDK%20documentation%3C%2FA%3E.%26nbsp%3B%20After%20extracting%2C%20run%20the%20setup.cmd%20to%20finish%20setup.%26nbsp%3B%20But%20with%20the%20Full%20install%2C%20setup.cmd%20will%20not%20need%20to%20download%20with%20wget.%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%3CSPAN%3EBe%20aware%2C%20this%20article%20was%20written%20when%20v0.17.4%20was%20the%20latest%20release%20of%20the%20Zephyr%20SDK.%26nbsp%3B%20Check%20here%20for%20the%20%3CA%20href%3D%22https%3A%2F%2Fgithub.com%2Fzephyrproject-rtos%2Fsdk-ng%2Ftags%26nbsp%3B%22%20target%3D%22_self%22%20rel%3D%22nofollow%20noopener%20noreferrer%22%3Elatest%20release%3C%2FA%3E.%3C%2FSPAN%3E%3C%2FP%3E%0A%3CP%3E%3CSPAN%3EReturn%20to%26nbsp%3B%3C%2FSPAN%3E%3CA%20href%3D%22https%3A%2F%2Fcommunity.nxp.com%2Ft5%2FZephyr-Project-Knowledge-Base%2FZephyr-Support-Resources%2Fta-p%2F2008548%22%20target%3D%22_blank%22%3EZephyr%20Knowledge%20Hub%3C%2FA%3E%3C%2FP%3E%0A%3C%2FLINGO-BODY%3E
No ratings
Version history
Last update:
‎02-02-2026 09:46 AM
Updated by: