Skip to content

Commit b227a67

Browse files
authored
Merge pull request #2505 from MikeMcC399/lts-tags
docs: add Long Term Support (LTS) README section
2 parents f2e1347 + c672466 commit b227a67

1 file changed

Lines changed: 23 additions & 0 deletions

File tree

README.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,11 +22,13 @@ The official Node.js docker image, made with love by the node community.
2222
- [npm run](#npm-run)
2323
- [Image Variants](#image-variants)
2424
- [`node:<version>`](#nodeversion)
25+
- [`node:lts`](#nodelts)
2526
- [`node:alpine`](#nodealpine)
2627
- [`node:bullseye`](#nodebullseye)
2728
- [`node:bookworm`](#nodebookworm)
2829
- [`node:trixie`](#nodetrixie)
2930
- [`node:slim`](#nodeslim)
31+
- [Long Term Support (LTS)](#long-term-support-lts)
3032
- [Release Availability](#release-availability)
3133
- [License](#license)
3234
- [Supported Docker versions](#supported-docker-versions)
@@ -159,6 +161,8 @@ The legacy package manager
159161
is included in `node` images with Node.js 25 and below. See
160162
[Yarn v1 Classic bundling](#yarn-v1-classic-bundling) for details.
161163

164+
View the list of currently supported floating and pinned tags on [Docker Hub](https://hub.docker.com/_/node).
165+
162166
### `node:<version>`
163167

164168
This is the defacto image. If you are unsure about what your needs are, you
@@ -171,6 +175,11 @@ on their system. It, by design, has a large number of extremely common Debian
171175
packages. This reduces the number of packages that images that derive from it
172176
need to install, thus reducing the overall size of all images on your system.
173177

178+
### `node:lts`
179+
180+
This is a special form of `node:<version>` that selects the
181+
Active Long Term Support version of Node.js. See also [Long Term Support](#long-term-support-lts) below for more detail.
182+
174183
### `node:alpine`
175184

176185
This image is based on the popular
@@ -231,6 +240,20 @@ in an environment where *only* the Node.js image will be deployed and you have
231240
space constraints, we highly recommend using the default image of this
232241
repository.
233242

243+
## Long Term Support (LTS)
244+
245+
Production applications should only use LTS releases.
246+
247+
Refer to [Node.js Releases](https://github.com/nodejs/release#readme) for a description
248+
of release phases and schedule.
249+
250+
If no version selection is made in a tag, for example, `node:slim`,
251+
then the Current release is selected.
252+
`node` images using the Active LTS release are published with an `lts` floating tag
253+
to aid their selection. `node:lts` can be used on its own, or in combination with other tags
254+
such as `node:lts-slim`. To select a `node` image based on a Maintenance LTS version
255+
use the literal node version in the tag.
256+
234257
## Release Availability
235258

236259
This repo automatically triggers a process to build new `node` images when Node.js releases

0 commit comments

Comments
 (0)