Skip to content

fix(downloads): use full version for Docker Alpha images - #9334

Merged
ovflowd merged 2 commits into
nodejs:mainfrom
MikeMcC399:docker-alpha
Nov 17, 2026
Merged

ovflowd merged 2 commits into
nodejs:mainfrom
MikeMcC399:docker-alpha

Conversation

@MikeMcC399

Copy link
Copy Markdown
Member

Description

For Docker download instructions of Node.js Alpha versions, replace the shared (floating) tag that specifies only <major version>-slim with a simple (pinned) tag consisting of <full version>-trixie-slim.

Node.js 27 Alpha Docker images published to https://hub.docker.com/_/node do not use floating tags at this time and must be selected by using a full pinned tag.

https://nodejs.org/en/download/alpha is currently showing the following instructions to download (pull) an Alpha Docker image:

# Pull the Node.js Docker image:
docker pull node:27-slim

This fails because no such tag exists.

Validation

Go to https://nodejs.org/en/download

Alpha

Select the current Alpha release for "Linux" using "Docker" with "npm":

Note the instructions:

# Docker has specific installation instructions for each operating system.
# Please refer to the official documentation at https://docker.com/get-started/

# Pull the Node.js Docker image:
docker pull node:27.0.0-alpha.0.1.0-trixie-slim

# Create a Node.js container and start a Shell session:
docker run -it --rm --entrypoint sh node:27.0.0-alpha.0.1.0-trixie-slim

# Verify the Node.js version:
node -v # Should print "v27.0.0-alpha.0.1.0".

# Verify npm version:
npm -v # Should print "12.2.2".

Confirm the instructions work.

LTS

Check there is no regression for non-Alpha releases.

Select the latest LTS release for "Linux" using "Docker" with "npm":

Note the instructions:

# Docker has specific installation instructions for each operating system.
# Please refer to the official documentation at https://docker.com/get-started/

# Pull the Node.js Docker image:
docker pull node:26-slim

# Create a Node.js container and start a Shell session:
docker run -it --rm --entrypoint sh node:26-slim

# Verify the Node.js version:
node -v # Should print "v26.13.1".

# Verify npm version:
npm -v # Should print "11.20.0".

Confirm the instructions work.

Related Issues

Resolves: #9332

Check List

cc: @nodejs/docker

Signed-off-by: Mike McCready <66998419+MikeMcC399@users.noreply.github.com>
@vercel

vercel Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
nodejs-org Ready Ready Preview Nov 17, 2026 1:45pm UTC

Request Review

@codecov

codecov Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 87.00%. Comparing base (7d9ba6f) to head (995875a).
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #9334      +/-   ##
==========================================
- Coverage   87.09%   87.00%   -0.10%     
==========================================
  Files          90       90              
  Lines        6426     6426              
  Branches      389      390       +1     
==========================================
- Hits         5597     5591       -6     
- Misses        825      831       +6     
  Partials        4        4              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

@MikeMcC399

Copy link
Copy Markdown
Member Author

Preview

image

@github-actions

Copy link
Copy Markdown
Contributor

📦 Build Size Comparison

Summary

Metric Value
Old Total First Load JS 7.19 MB
New Total First Load JS 7.19 MB
Delta 0 B (0.00%)

@MikeMcC399

MikeMcC399 commented Nov 16, 2026 •

Copy link
Copy Markdown
Member Author

Playwright tests are failing in CI for unrelated reasons. This would need to be separately investigated.

Other new PRs such as #9330 are also failing.

Edit: logged in #9335

@MikeMcC399
MikeMcC399 marked this pull request as ready for review November 16, 2026 09:44
@MikeMcC399
MikeMcC399 requested a review from a team as a code owner November 16, 2026 09:44
Copilot AI balanced review requested due to automatic review settings November 16, 2026 09:44

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues are reported for the update to use full-version Docker image tags for Node.js Alpha releases.

No open issues 🎉

What changed in this PR

Fixes the website’s Docker download instructions for Node.js Alpha releases by using full-version image tags, addressing issue #9332.

Changes:

  • Uses <full version>-trixie-slim for Alpha images in both docker pull and docker run.
  • Preserves <major version>-slim tags for non-Alpha releases.
File Description
apps/​site/​snippets/​en/​download/​docker.bash Selects pinned Alpha image tags while retaining existing tags for other releases.

Review effort: Balanced

@ovflowd
ovflowd merged commit 18b1d42 into nodejs:main Nov 17, 2026
12 of 14 checks passed
@ovflowd ovflowd added the fast-track Fast Tracking PRs label Nov 17, 2026
@ovflowd

ovflowd commented Nov 17, 2026

Copy link
Copy Markdown
Member

Merging as a hot fix cc @nodejs/nodejs-website

@MikeMcC399
MikeMcC399 deleted the docker-alpha branch November 17, 2026 14:09

This branch was successfully deployed

1 active deployment
Preview — 995875ad Deployed Nov 17, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

fast-track Fast Tracking PRs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Non-working instructions to pull Node.js 27 Alpha Docker images

3 participants