Skip to content

docs: add supported architectures section#2498

Open
MikeMcC399 wants to merge 1 commit into
nodejs:mainfrom
MikeMcC399:architecture-support
Open

docs: add supported architectures section#2498
MikeMcC399 wants to merge 1 commit into
nodejs:mainfrom
MikeMcC399:architecture-support

Conversation

@MikeMcC399
Copy link
Copy Markdown
Contributor

Description

Add a new section "Supported architectures" to the README.md document.

Motivation and Context

The README.md document does not currently describe the support status of the underlying architectures used in the node Docker images.

Debian images (trixie, bookworm & bullseye) all use architectures covered in Node.js Support tiers 1 & 2. These are glibc C library based.

Alpine images rely on musl C library support from nodejs/unofficial-builds that are classified as "Experimental".

node:alpine* images are in wide and successful use since their introduction 10 years ago. Users who choose these images should nevertheless be made aware of the support status of the images. Docker Hub node does not describe support categories.

nodejs/node#62764 seeks to promote Alpine from "Experimental" to "Tier 2" and awareness of the current status may assist in recruiting volunteers to provide additional support and achieve the needed support level promotion.

Testing Details

N/A - documentation change only

Types of changes

  • Documentation
  • Version change (Update, remove or add more Node.js versions)
  • Variant change (Update, remove or add more variants, or versions of variants)
  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Other (none of the above)

Checklist

  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING.md document.
  • All new and existing tests passed.

@MikeMcC399 MikeMcC399 marked this pull request as ready for review May 13, 2026 10:13
@MikeMcC399 MikeMcC399 requested review from Copilot and sxa and removed request for Copilot May 13, 2026 10:13
@MikeMcC399
Copy link
Copy Markdown
Contributor Author

Comment thread README.md Outdated
Comment thread README.md Outdated
Co-authored-by: Stewart X Addison <6487691+sxa@users.noreply.github.com>
@MikeMcC399 MikeMcC399 force-pushed the architecture-support branch from ba00e06 to dabd72a Compare May 13, 2026 11:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add architecture dependent supportability information

2 participants