gatsbyjs/gatsby · error

You are currently using a prerelease version of Node (${vers

Error message

You are currently using a prerelease version of Node (${version}), which is not supported.
You can use this for testing, but we do not recommend it in production.
Before reporting any bugs, please test with a supported version of Node (>=${MIN_NODE_VERSION}).

What it means

Error "You are currently using a prerelease version of Node (${version}), which is not supported. You can use this for testing, but we do not recommend it in production. Before reporting any bugs, please test with a supported version of Node (>=${MIN_NODE_VERSION})." thrown in gatsbyjs/gatsby.

Source

Thrown at packages/gatsby-cli/src/index.ts:41

// const NEXT_MIN_NODE_VERSION = `10.13.0`

const { version } = process

if (
  !semver.satisfies(version, `>=${MIN_NODE_VERSION}`, {
    includePrerelease: true,
  })
) {
  report.panic(
    report.stripIndent(`
      Gatsby requires Node.js ${MIN_NODE_VERSION} or higher (you have ${version}).
      Upgrade Node to the latest stable release: https://gatsby.dev/upgrading-node-js
    `)
  )
}

if (semver.prerelease(version)) {
  report.warn(
    report.stripIndent(`
    You are currently using a prerelease version of Node (${version}), which is not supported.
    You can use this for testing, but we do not recommend it in production.
    Before reporting any bugs, please test with a supported version of Node (>=${MIN_NODE_VERSION}).`)
  )
}

// if (!semver.satisfies(version, `>=${NEXT_MIN_NODE_VERSION}`)) {
//   report.warn(
//     report.stripIndent(`
//       Node.js ${version} has reached End of Life status on 31 December, 2019.
//       Gatsby will only actively support ${NEXT_MIN_NODE_VERSION} or higher and drop support for Node 8 soon.
//       Please upgrade Node.js to a currently active LTS release: https://gatsby.dev/upgrading-node-js
//     `)
//   )
// }

process.on(`unhandledRejection`, reason => {

View on GitHub (pinned to e85d62f177)

Solutions

1. Test with a stable supported Node release before reporting bugs
2. Avoid prerelease Node versions in production builds

When it happens

Trigger: Thrown at packages/gatsby-cli/src/index.ts:41 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of gatsbyjs/gatsby@e85d62f177 (2026-08-26). Data as JSON: /api/errors/bce73b94e97f48ad. Report an issue: GitHub.