{"record":{"id":"58a9eaf59392884b","repo":"gatsbyjs/gatsby","slug":"gatsby-requires-node-js-min-node-version-or-hig-58a9ea","errorCode":null,"errorMessage":"Gatsby requires Node.js ${MIN_NODE_VERSION} or higher (you have ${version}).\nUpgrade Node to the latest stable release: https://gatsby.dev/upgrading-node-js","messagePattern":"Gatsby requires Node\\.js (.+?) or higher \\(you have (.+?)\\)\\.\nUpgrade Node to the latest stable release: https://gatsby\\.dev/upgrading-node-js","errorType":"panic","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/gatsby-cli/src/index.ts","lineNumber":32,"sourceCode":"}\n\n// Ensure stable runs on Windows when started from different shells (i.e. c:\\dir vs C:\\dir)\nif (os.platform() === `win32`) {\n  ensureWindowsDriveLetterIsUppercase()\n}\n\n// @ts-ignore - TODO: Remove _CFLAGS_ again\nconst MIN_NODE_VERSION = _CFLAGS_.GATSBY_MAJOR === `5` ? `18.0.0` : `14.15.0`\n// const NEXT_MIN_NODE_VERSION = `10.13.0`\n\nconst { version } = process\n\nif (\n  !semver.satisfies(version, `>=${MIN_NODE_VERSION}`, {\n    includePrerelease: true,\n  })\n) {\n  report.panic(\n    report.stripIndent(`\n      Gatsby requires Node.js ${MIN_NODE_VERSION} or higher (you have ${version}).\n      Upgrade Node to the latest stable release: https://gatsby.dev/upgrading-node-js\n    `)\n  )\n}\n\nif (semver.prerelease(version)) {\n  report.warn(\n    report.stripIndent(`\n    You are currently using a prerelease version of Node (${version}), which is not supported.\n    You can use this for testing, but we do not recommend it in production.\n    Before reporting any bugs, please test with a supported version of Node (>=${MIN_NODE_VERSION}).`)\n  )\n}\n\n// if (!semver.satisfies(version, `>=${NEXT_MIN_NODE_VERSION}`)) {\n//   report.warn(","sourceCodeStart":14,"sourceCodeEnd":50,"githubUrl":"https://github.com/gatsbyjs/gatsby/blob/e85d62f1779e353eaac1753211629a26d123e26c/packages/gatsby-cli/src/index.ts#L14-L50","documentation":"CLI startup check in gatsby-cli: semver reports the running Node version does not satisfy the minimum required by this Gatsby major (18.0.0 for v5). report.panic aborts before any command runs, directing the user to upgrade Node.","triggerScenarios":"Thrown at packages/gatsby-cli/src/index.ts:32 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Upgrade Node.js to the latest stable release (>= 18 for Gatsby 5)","Use nvm to install/switch to a supported Node version","Ensure CI/deploy environments also use a supported Node version"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"e85d62f1779e353eaac1753211629a26d123e26c","analyzedAt":"2026-08-26T17:50:09.662Z","contentChangedAt":"2026-08-26T17:50:09.662Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}