From 9514401138ca44253ccb6a1437694bc74ea50bed Mon Sep 17 00:00:00 2001 From: Mike McCready <66998419+MikeMcC399@users.noreply.github.com> Date: Sun, 1 Feb 2026 17:32:09 +0100 Subject: [PATCH 1/2] Deprecate Yarn v1 --- README.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 8dfecc3f9..ed682b822 100644 --- a/README.md +++ b/README.md @@ -30,6 +30,7 @@ The official Node.js docker image, made with love by the node community. - [License](#license) - [Supported Docker versions](#supported-docker-versions) - [Supported Node.js versions](#supported-nodejs-versions) +- [Yarn v1 Classic bundling](#yarn-v1-classic-bundling) - [Governance and Current Members](#governance-and-current-members) - [Docker Working Group Members](#docker-working-group-members) - [Docker Working Group Collaborators](#docker-working-group-collaborators) @@ -147,10 +148,12 @@ $ docker run node npm --loglevel=warn ... The `node` images come in many flavors, each designed for a specific use case. All of the images contain pre-installed versions of `node`, -[`npm`](https://www.npmjs.com/), and [`yarn`](https://yarnpkg.com). For each +[`npm`](https://www.npmjs.com/), and [Yarn v1 Classic](https://classic.yarnpkg.com/). For each supported architecture, the supported variants are different. In the file: [versions.json](./versions.json), it lists all supported variants for all of the architectures that we support now. +See [Yarn v1 Classic bundling](#yarn-v1-classic-bundling) for future plans to +remove this legacy version. ### `node:` @@ -248,6 +251,19 @@ upgrade your Docker daemon. This project will support Node.js versions as still under active support as per the [Node.js release schedule](https://github.com/nodejs/Release). +## Yarn v1 Classic bundling + +[Yarn v1 Classic](https://classic.yarnpkg.com/) is currently bundled in `node` image +variants. Because Yarn v1 is [frozen](https://github.com/yarnpkg/yarn) and no longer maintained, +bundling plans have been revised. + +As of Node.js 26.0.0 it is planned to no longer bundle Yarn v1 into `node` images. +`node` images for lower versions of Node.js (<26) will continue to bundle Yarn v1. + +Users with legacy requirements for Yarn v1 under Node.js 26 and above may be able +to follow [Yarn v1 installation instructions](https://classic.yarnpkg.com/en/docs/install) +and install using `npm install --global yarn`. + ## Governance and Current Members The Node.js Docker Image is governed by the Docker Working Group. See From 9df7f37311133a25c71d11eaac7ca136d22b969d Mon Sep 17 00:00:00 2001 From: Mike McCready <66998419+MikeMcC399@users.noreply.github.com> Date: Sun, 1 Feb 2026 17:44:08 +0100 Subject: [PATCH 2/2] switch sentence order to avoid repetition --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index ed682b822..474584cad 100644 --- a/README.md +++ b/README.md @@ -258,7 +258,7 @@ variants. Because Yarn v1 is [frozen](https://github.com/yarnpkg/yarn) and no lo bundling plans have been revised. As of Node.js 26.0.0 it is planned to no longer bundle Yarn v1 into `node` images. -`node` images for lower versions of Node.js (<26) will continue to bundle Yarn v1. +For lower versions of Node.js (<26) `node` images will continue to bundle Yarn v1. Users with legacy requirements for Yarn v1 under Node.js 26 and above may be able to follow [Yarn v1 installation instructions](https://classic.yarnpkg.com/en/docs/install)