Skip to content
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/content/docs/en/guides/deploy/microsoft-azure.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ The GitHub action yaml that is created for you assumes the use of node 14. This

```
"engines": {
"node": ">=18.0.0"
"node": ">=22.0.0"
},
```

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/en/guides/deploy/netlify.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ You can also create a new site on Netlify and link up your Git repository by ins

### Set a Node.js version

If you are using a legacy [build image](https://docs.netlify.com/configure-builds/get-started/#build-image-selection) (Xenial) on Netlify, make sure that your Node.js version is set. Astro requires `v18.20.8` or `v20.3.0` or higher.
If you are using a legacy [build image](https://docs.netlify.com/configure-builds/get-started/#build-image-selection) (Xenial) on Netlify, make sure that your Node.js version is set. Astro requires `v22.0.0` or higher.

You can [specify your Node.js version in Netlify](https://docs.netlify.com/configure-builds/manage-dependencies/#node-js-and-javascript) using:
- a [`.nvmrc`](https://github.com/nvm-sh/nvm#nvmrc) file in your base directory.
Expand Down
28 changes: 28 additions & 0 deletions src/content/docs/en/guides/upgrade-to/v6.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,34 @@ See [the Astro changelog](https://github.com/withastro/astro/blob/main/packages/

Any major upgrades to Astro's dependencies may cause breaking changes in your project.

### Node 22

<SourcePR number="14427" title="feat!: drop node 18 and 20"/>

Node 18 reached its End of Life in March 2025 and Node 20 is scheduled to reach its End of Life in April 2026.

Astro v6.0 drops Node 18 and Node 20 support entirely so that all Astro users can take advantage of Node's more modern features.

#### What should I do?

Check that both your development environment and your deployment environment are using **Node `22.0.0` or higher**.

<Steps>
1. Check your local version of Node using:

```sh
node -v
```

2. Check your [deployment environment's](/en/guides/deploy/) own documentation to verify that they support Node 22.

You can specify Node `22.0.0` for your Astro project either in a dashboard configuration setting or a `.nvmrc` file.

```bash title=".nvmrc"
22.0.0
```
</Steps>

## Legacy

The following features are now considered legacy features. They should function normally but are no longer recommended and are in maintenance mode. They will see no future improvements and documentation will not be updated. These features will eventually be deprecated, and then removed entirely.
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/en/install-and-setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Prefer to try Astro in your browser? Visit [astro.new](https://astro.new/) to br

## Prerequisites

- **Node.js** - `v18.20.8` or `v20.3.0`, `v22.0.0` or higher. ( `v19` and `v21` are not supported.)
- **Node.js** - `v22.0.0` or higher. Odd-numbered versions like `v23` are not supported.
- **Text editor** - We recommend [VS Code](https://code.visualstudio.com/) with our [Official Astro extension](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode).
- **Terminal** - Astro is accessed through its command-line interface (CLI).

Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/en/tutorial/1-setup/1.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,15 +28,15 @@ You can access the command line through a local terminal program for your operat

### Node.js

For Astro to run on your system, you will also need to have a compatible version of [**Node.js**](https://nodejs.org/en/) installed. Astro supports **even-numbered** Node.js versions. The current minimum supported versions of each are: `v18.20.8`, `v20.3.0`, and `v22.0.0`. (`v19` and `v21` are not supported.)
For Astro to run on your system, you will also need to have a compatible version of [**Node.js**](https://nodejs.org/en/) installed. Astro supports **even-numbered** Node.js versions. The current minimum supported version is: `v22.0.0`. (odd-numbered versions like `v23` are not supported.)

To check to see whether you already have a compatible version installed, run the following command in your terminal:

```sh
node -v

// Example output
v18.20.8
v22.20.0
```

If the command returns a version number supported by Astro, you're good to go!
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/en/upgrade-astro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -194,7 +194,7 @@ A major release may also include some non-breaking changes and improvements that
The following rules define when Astro may deprecate, drop, or add support for versions of Node.js:

- Odd versions of Node.js can be deprecated and/or dropped when the next even version of Node.js published. This change can occur in a **minor** release of Astro, after a reasonable period of extended support as decided by the Astro Core team.
- Upgrading the minimum **_Maintenance_ LTS** (within the same major range, e.g. from `v18.14.*` to `v18.20.*`) version of Node.js can occur in a **minor** release of Astro.
- Upgrading the minimum **_Maintenance_ LTS** (within the same major range, e.g. from `22.14.*` to `22.20.*`) version of Node.js can occur in a **minor** release of Astro.
- Security exception: If a security flaw in Node.js that **affects Astro** is disclosed and fixed, the Core team can bump the minimum version of the **_Maintenance_ LTS** in a **patch** release.
- Upgrading minor or major versions of Node.js (**not** Maintenance LTS) occurs only in major versions of Astro.
- Security exception: If a security flaw in Node.js that **affects Astro** is disclosed and fixed, the Core team can bump the minimum version in a **minor** release.
Expand Down
Loading