From 74e532603c695ccb1d7e7af17be00c2af67da9a8 Mon Sep 17 00:00:00 2001 From: Mike McCready <66998419+MikeMcC399@users.noreply.github.com> Date: Thu, 14 May 2026 13:11:57 +0200 Subject: [PATCH 1/3] docs: add Long Term Support (LTS) README section --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/README.md b/README.md index e1467ad32..d9d36127b 100644 --- a/README.md +++ b/README.md @@ -27,6 +27,7 @@ The official Node.js docker image, made with love by the node community. - [`node:bookworm`](#nodebookworm) - [`node:trixie`](#nodetrixie) - [`node:slim`](#nodeslim) +- [Long Term Support (LTS)](#long-term-support-lts) - [Release Availability](#release-availability) - [License](#license) - [Supported Docker versions](#supported-docker-versions) @@ -231,6 +232,21 @@ in an environment where *only* the Node.js image will be deployed and you have space constraints, we highly recommend using the default image of this repository. +## Long Term Support (LTS) + +Production applications should only use Active LTS or Maintenance LTS releases. + +Refer to [Node.js Releases](https://github.com/nodejs/release#readme) for a description +of release phases and schedule. + +If no version selection is made in a tag, then the Current release is selected. +`node` images using the Active LTS release are published with an `lts` floating tag +to aid their selection. `node:lts` can be used on its own, or in combination with other tags +such as `node:lts-slim`. To select a `node` image based on a Maintenance LTS version +use the literal node version in the tag. + +View the list of currently supported floating and pinned tags on [Docker Hub](https://hub.docker.com/_/node). + ## Release Availability This repo automatically triggers a process to build new `node` images when Node.js releases From 94a19a3b2c44327d77925594802cdf2c911ebc73 Mon Sep 17 00:00:00 2001 From: Mike McCready <66998419+MikeMcC399@users.noreply.github.com> Date: Fri, 15 May 2026 08:02:27 +0200 Subject: [PATCH 2/3] add node:lts section --- README.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index d9d36127b..099e3f594 100644 --- a/README.md +++ b/README.md @@ -22,6 +22,7 @@ The official Node.js docker image, made with love by the node community. - [npm run](#npm-run) - [Image Variants](#image-variants) - [`node:`](#nodeversion) + - [`node:lts`](#nodelts) - [`node:alpine`](#nodealpine) - [`node:bullseye`](#nodebullseye) - [`node:bookworm`](#nodebookworm) @@ -160,6 +161,8 @@ The legacy package manager is included in `node` images with Node.js 25 and below. See [Yarn v1 Classic bundling](#yarn-v1-classic-bundling) for details. +View the list of currently supported floating and pinned tags on [Docker Hub](https://hub.docker.com/_/node). + ### `node:` This is the defacto image. If you are unsure about what your needs are, you @@ -172,6 +175,11 @@ on their system. It, by design, has a large number of extremely common Debian packages. This reduces the number of packages that images that derive from it need to install, thus reducing the overall size of all images on your system. +### `node:lts` + +This is a special form of `node:` that selects the +Active Long Term Support version of Node.js. See also [Long Term Support](#long-term-support-lts) below for more detail. + ### `node:alpine` This image is based on the popular @@ -239,14 +247,13 @@ Production applications should only use Active LTS or Maintenance LTS releases. Refer to [Node.js Releases](https://github.com/nodejs/release#readme) for a description of release phases and schedule. -If no version selection is made in a tag, then the Current release is selected. +If no version selection is made in a tag, for example, `node:slim`, +then the Current release is selected. `node` images using the Active LTS release are published with an `lts` floating tag to aid their selection. `node:lts` can be used on its own, or in combination with other tags such as `node:lts-slim`. To select a `node` image based on a Maintenance LTS version use the literal node version in the tag. -View the list of currently supported floating and pinned tags on [Docker Hub](https://hub.docker.com/_/node). - ## Release Availability This repo automatically triggers a process to build new `node` images when Node.js releases From 0332e24485b3c46ce6087c59717b94b24ad42fcf Mon Sep 17 00:00:00 2001 From: Mike McCready <66998419+MikeMcC399@users.noreply.github.com> Date: Fri, 15 May 2026 16:25:40 +0200 Subject: [PATCH 3/3] Simplify LTS reference Co-authored-by: Stewart X Addison <6487691+sxa@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 099e3f594..e5b417fb2 100644 --- a/README.md +++ b/README.md @@ -242,7 +242,7 @@ repository. ## Long Term Support (LTS) -Production applications should only use Active LTS or Maintenance LTS releases. +Production applications should only use LTS releases. Refer to [Node.js Releases](https://github.com/nodejs/release#readme) for a description of release phases and schedule.