Skip to content

[v22.x backport] doc: promote Alpine Linux to tier 2 support - #66591

Open
MikeMcC399 wants to merge 1 commit into
nodejs:v22.x-stagingfrom
MikeMcC399:backport-63737-to-v22.x
Open

MikeMcC399 wants to merge 1 commit into
nodejs:v22.x-stagingfrom
MikeMcC399:backport-63737-to-v22.x

Conversation

@MikeMcC399

Copy link
Copy Markdown
Contributor

Backports #63737 to v22.x

kernel >= 6.12, musl >= 1.2.5 updated to align with lowest supported version Alpine Linux 3.21
see https://alpinelinux.org/releases/
see https://alpinelinux.org/posts/Alpine-3.21.0-released.html

Alpine 3.22 listed as example version

PR-URL: #63737
Reviewed-By: Matteo Collina matteo.collina@gmail.com
Reviewed-By: Rafael Gonzaga rafael.nunu@hotmail.com
Reviewed-By: Robert Nagy ronagy@icloud.com
Reviewed-By: Chengzhong Wu legendecas@gmail.com
Reviewed-By: Ruy Adorno ruy@vlt.sh
Reviewed-By: Joyee Cheung joyeec9h3@gmail.com
Reviewed-By: Richard Lau richard.lau@ibm.com
Reviewed-By: Ulises Gascón ulisesgascongonzalez@gmail.com
Reviewed-By: James M Snell jasnell@gmail.com
Reviewed-By: Mike McCready 66998419+MikeMcC399@users.noreply.github.com

This manual backport is needed because bcf5850 from #63737 does not cleanly backport. The width of the table https://github.com/nodejs/node/blob/main/BUILDING.md#platform-list in the main and v22.x branches is different.

Background

Node.js does not support a platform version if a vendor has expired support for it.
The lowest Alpine Linux version supported is v3.21 according to https://alpinelinux.org/releases/, so
minimum versions are aligned to Alpine v3.21 and are bumped to:

kernel >= 6.12, musl >= 1.2.5

Documentation backport needed as reference for the support description in nodejs/docker-node for Alpine Linux x64 images. Docker documentation needs to move from describing these builds as "Experimental" to categorizing them as falling under "Tier 2" support - see musl builds for Alpine.

@MikeMcC399 MikeMcC399 added semver-minor PRs that contain new features and should be released in the next minor version. alpine Issues and PRs related to the Alpine Linux platform. labels Oct 8, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/build
  • @nodejs/tsc

@nodejs-github-bot nodejs-github-bot added build Issues and PRs related to Node.js builds or CI infrastructure. doc Issues and PRs related to Node.js documentation. v22.x Issues that can be reproduced on v22.x or PRs targeting the v22.x-staging branch. labels Oct 8, 2026
@MikeMcC399 MikeMcC399 changed the title doc: promote Alpine Linux to tier 2 support [v22.x backport] doc: promote Alpine Linux to tier 2 support Oct 8, 2026
kernel >= 6.12, musl >= 1.2.5
updated to align with lowest supported version Alpine Linux 3.21
see https://alpinelinux.org/releases/
see https://alpinelinux.org/posts/Alpine-3.21.0-released.html

Alpine 3.22 listed as example version

Signed-off-by: Stewart X Addison <sxa@ibm.com>
PR-URL: nodejs#63737
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Rafael Gonzaga <rafael.nunu@hotmail.com>
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: Chengzhong Wu <legendecas@gmail.com>
Reviewed-By: Ruy Adorno <ruy@vlt.sh>
Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com>
Reviewed-By: Richard Lau <richard.lau@ibm.com>
Reviewed-By: Ulises Gascón <ulisesgascongonzalez@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Mike McCready <66998419+MikeMcC399@users.noreply.github.com>
@MikeMcC399
MikeMcC399 force-pushed the backport-63737-to-v22.x branch from a26aceb to 81d5c0c Compare October 8, 2026 06:46
@MikeMcC399
MikeMcC399 marked this pull request as ready for review October 8, 2026 06:47
@MikeMcC399
MikeMcC399 requested a review from sxa October 8, 2026 09:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

alpine Issues and PRs related to the Alpine Linux platform. build Issues and PRs related to Node.js builds or CI infrastructure. doc Issues and PRs related to Node.js documentation. semver-minor PRs that contain new features and should be released in the next minor version. v22.x Issues that can be reproduced on v22.x or PRs targeting the v22.x-staging branch.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants