How to Fix Node.js Is Not Supported by Astro

This error means your Node.js is too old for Astro. Astro 7.4 needs Node.js 22.23.4 or newer. Run node -v to see what you have. If it’s older, install the newest LTS version from nodejs.org. Then close your terminal, open a new one, and try again.

Why it happens

Node.js is the engine that runs Astro on your computer. Each new Astro needs a fairly new Node.js. If yours is old, Astro stops before it starts.

You may have installed Node.js a long time ago. Or your computer may have two versions, and your terminal is using the old one.

First, we checked our own version. It’s new enough, so Astro worked:

$ node -v
v24.21.0

Next, we read Astro 7.4’s own files. The package.json inside Astro says it needs this:

"engines": {
  "node": ">=22.23.4"
}

The >= means “this version or newer”. Astro’s install guide says the same. It also says odd-numbered versions, like 23, are not supported.

Last, we read the code that prints the error. It shows these two lines, with your version in place of the X’s:

Node.js vX.X.X is not supported by Astro!
Please upgrade Node.js to a supported version: ">=22.23.4"

How to fix it

1. Check your version. Run node -v. If the number is below 22.23.4, you need a new one.
2. Install a new Node.js. Go to nodejs.org and download the LTS version. LTS means “long-term support”. It’s the safe choice.
3. Close your terminal and open a new one. Your old terminal still remembers the old version.
4. Check again. Run node -v. You should see the new number.
5. Reinstall your project’s tools. In your project folder, run npm install. Then run npm run dev.

Still stuck?

• If node -v still shows the old number, you may have two copies of Node.js. Paste the output of which node (Mac) or where node (Windows) into an AI. Our guide on fixing Astro errors with AI shows what to say.
• Ask in our community. Tell people which version node -v shows.

Where to go next

• How to fix the most common Astro errors for other errors beginners hit.
• How to fix astro: command not found if Astro still won’t start.