{"record":{"id":"34231da51e7e53bb","repo":"jdx/mise","slug":"precompiled-node-archive-not-found-and-compilation","errorCode":null,"errorMessage":"precompiled node archive not found and compilation is disabled","messagePattern":"precompiled node archive not found and compilation is disabled","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/plugins/core/node.rs","lineNumber":150,"sourceCode":"            }\n            FetchOutcome::NotFound => {\n                if ctx.locked {\n                    if let Some(message) = node_flavor_not_found_message(opts) {\n                        bail!(\"{message}\\nlocked mode requires the locked precompiled artifact\")\n                    }\n                    bail!(\n                        \"precompiled node archive not found and locked mode requires the locked precompiled artifact\"\n                    )\n                } else if Settings::get().node_compile(CompilePurpose::Inspect) != Some(false) {\n                    if let Some(message) = node_flavor_not_found_message(opts) {\n                        warn!(\"{message}\");\n                    }\n                    self.install_compiling(ctx, tv, opts).await\n                } else {\n                    if let Some(message) = node_flavor_not_found_message(opts) {\n                        bail!(\"{message}\\ncompilation is disabled\")\n                    }\n                    bail!(\"precompiled node archive not found and compilation is disabled\")\n                }\n            }\n        }\n    }\n\n    async fn install_windows(\n        &self,\n        ctx: &InstallContext,\n        tv: &mut ToolVersion,\n        opts: &BuildOpts,\n    ) -> Result<()> {\n        match self\n            .fetch_binary(ctx, tv, opts, || self.extract_zip(opts, ctx))\n            .await?\n        {\n            FetchOutcome::Downloaded => {\n                warn_patches_not_applied();\n                Ok(())","sourceCodeStart":132,"sourceCodeEnd":168,"githubUrl":"https://github.com/jdx/mise/blob/afd2eddd3a50c16190efc1c7e94404b48f72af57/src/plugins/core/node.rs#L132-L168","documentation":"Fallback variant of the node install failure: when no precompiled Node archive exists for the version/platform AND there is no specific flavor-not-found message, mise aborts with this generic message because node.compile is disabled. Node core plugin only installs precompiled binaries unless compilation is explicitly enabled.","triggerScenarios":"`mise install node@<version>` where the nodejs.org dist URL 404s for the current platform/arch and settings node.compile is not enabled.","commonSituations":"Very new Node releases not yet mirrored; dropped platforms (e.g. 32-bit Linux, older macOS); unofficial flavors without prebuilt assets.","solutions":["Run `mise settings node.compile=true` to allow building from source","Pick a Node version with published prebuilt binaries for your platform","Use a different backend (e.g. a vfox node plugin) if you need an unsupported platform"],"exampleFix":"// before\nmise install node@23.0.0  // 404 on prebuilt\n\n// after\nmise settings set node.compile true\nmise install node@23.0.0","handlingStrategy":"fallback","validationCode":"url=\"https://nodejs.org/dist/latest-v20.x/SHASUMS256.txt\"\ncurl -fsSL \"$url\" | grep -q \"$(node -p 'process.platform')-$(node -p 'process.arch').tar.gz\" || echo 'no prebuilt; enable node.compile'","typeGuard":null,"tryCatchPattern":"if ! mise install node@\"$VER\"; then\n  mise settings set node.compile true\n  mise install node@\"$VER\"\nfi","preventionTips":["Verify SHASUMS256.txt lists your platform before pinning a node version","Avoid 32-bit / end-of-life platforms the dist server no longer serves","Enable node.compile for environments where you control a compiler toolchain"],"tags":["node","install","precompiled","compilation-disabled"],"backgroundTag":"resource-not-found","analyzedSha":"afd2eddd3a50c16190efc1c7e94404b48f72af57","analyzedAt":"2026-09-09T01:38:25.179Z","contentChangedAt":"2026-09-09T01:38:25.179Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}