Neutralino "neu build" binaries not downloaded in CI
Neutralino keeps its platform binaries out of the repo; neu update downloads them based on neutralino.config.json. Without that step, neu build has no binaries to package and fails in CI.
What this error means
neu build fails or produces nothing because the bin/ binaries are absent, or it reports it cannot find the Neutralino binaries for the target platform.
neutralinojs
Unable to find Neutralino binaries. Run `neu update` to download
the binaries before building.
Error: ENOENT: no such file or directory, scandir 'bin'Common causes
neu update was never run
A fresh checkout has no bin/ binaries; neu build needs them, but the download step neu update was skipped.
The binaries were gitignored and not restored
bin/ is excluded from version control, so a clean CI clone starts without it and nothing restores it.
How to fix it
Run neu update before neu build
- Install the Neutralino CLI.
- Run
neu updateto download the binaries listed in the config. - Then run
neu build.
Terminal
npm install -g @neutralinojs/neu
neu update
neu build --releaseCache the downloaded binaries
Persist bin/ across runs so the download is not repeated on every job.
.github/workflows/ci.yml
- uses: actions/cache@v4
with:
path: bin
key: neu-bin-${{ hashFiles('neutralino.config.json') }}How to prevent it
- Always run
neu updatebeforeneu buildin CI. - Cache the bin/ directory keyed on the config.
- Pin the Neutralino CLI version for reproducible downloads.
Related guides
Electron "Failed to download" the Electron binary in CIFix Electron "Error: Failed to download" / "RequestError" during postinstall in CI - the runner could not fet…
Tauri "failed to bundle project" linuxdeploy / AppImage in CIFix Tauri "Error failed to bundle project" from linuxdeploy / appimagetool in CI - the AppImage bundling step…
Electron "Cannot find module 'electron'" in CIFix Electron "Error: Cannot find module 'electron'" in CI - the electron package was not installed, its posti…