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
Member

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 [email protected]
Reviewed-By: Rafael Gonzaga [email protected]
Reviewed-By: Robert Nagy [email protected]
Reviewed-By: Chengzhong Wu [email protected]
Reviewed-By: Ruy Adorno [email protected]
Reviewed-By: Joyee Cheung [email protected]
Reviewed-By: Richard Lau [email protected]
Reviewed-By: Ulises Gascón [email protected]
Reviewed-By: James M Snell [email protected]
Reviewed-By: Mike McCready [email protected]

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
@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
@MikeMcC399
MikeMcC399 force-pushed the backport-63737-to-v24.x branch 2 times, most recently from 82b88f1 to bfa0bbf Compare November 12, 2026 10:14
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 <[email protected]>
PR-URL: nodejs#63737
Reviewed-By: Matteo Collina <[email protected]>
Reviewed-By: Rafael Gonzaga <[email protected]>
Reviewed-By: Robert Nagy <[email protected]>
Reviewed-By: Chengzhong Wu <[email protected]>
Reviewed-By: Ruy Adorno <[email protected]>
Reviewed-By: Joyee Cheung <[email protected]>
Reviewed-By: Richard Lau <[email protected]>
Reviewed-By: Ulises Gascón <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Mike McCready <[email protected]>
@MikeMcC399
MikeMcC399 force-pushed the backport-63737-to-v24.x branch from bfa0bbf to 2c6ecdd Compare November 12, 2026 10:16
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.

4 participants