Visitar URL original
[v24.x backport] doc: promote Alpine Linux to tier 2 support by MikeMcC399 · Pull Request #66588 · nodejs/node · GitHub
Skip to content

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

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

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

Conversation

@MikeMcC399

Copy link
Copy Markdown
Contributor

Backports #63737 to v24.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 v24.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 the alpine Issues and PRs related to the Alpine Linux platform. label 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. v24.x Issues that can be reproduced on v24.x or PRs targeting the v24.x-staging branch. labels Oct 8, 2026
@MikeMcC399 MikeMcC399 added the semver-minor PRs that contain new features and should be released in the next minor version. label Oct 8, 2026
@MikeMcC399
MikeMcC399 marked this pull request as ready for review October 8, 2026 06:27
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-v24.x branch from 4aca824 to b6069ba Compare October 8, 2026 06:49
@MikeMcC399
MikeMcC399 requested a review from sxa October 8, 2026 09:01
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. v24.x Issues that can be reproduced on v24.x or PRs targeting the v24.x-staging branch.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants