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
Member

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 [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 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
@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
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-v22.x branch from 7a20851 to c5b4b78 Compare November 11, 2026 20: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. 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.

4 participants