Thank you for your contribution. Here are a set of guidelines for contributing to the docker-node project.
Project governance uses consensus seeking. See GOVERNANCE.md for roles and the decision process.
For governance-sensitive or potentially contentious changes, open a PR (or issue) with rationale and allow time for async feedback.
If a final decision cannot be reached via consensus seeking, escalation goes to the Node.js TSC as final arbiter.
You can use Node.js channels (prefixed by #nodejs-) in the OpenJSF Slack workspace for discussions.
-
#nodejs-distributions covers discussions for this repo (
docker-node). -
#nodejs-release is linked to the Node.js Release Working Group responsible for the upstream releases of Node.js used by this repo.
New Node.js releases are released as soon as possible.
New npm releases are not tracked. We simply use the npm version bundled in the corresponding Node.js release.
Yarn v1 Classic is no longer maintained upstream, and will be removed starting with the Node 26 images.
- Every 15 minutes, the workflow within the nodejs/docker-node repo checks for new versions of Node.js published to the website's
index.jsonfile.- If found, it also checks for an unofficial musl/Alpine build.
- If found, the update script runs
- The workflow opens a pull request either automatically via nodejs-github-bot or in some cases manually, such as when there is a new major release.
- Another workflow detects the merger of these pull requests and opens a pull request to docker-library/official-images.
- The official images are built and published according to docker's process, resulting in the new images being available on Docker Hub.
If you'd like to help us by submitting a PR for a version update, please do the following:
- Fork this project.
- Clone the forked repository.
- Create a branch for the update PR. For example,
git checkout main; git checkout -b version-update. - Run
./update.sh. You can see additional options by using accessing the built-in help documentation with./update.sh -h. This script will automatically update the appropriate files with the latest versions and checksums. - Commit the modified files to the
version-updatebranch and push the branch to your fork. - Create a PR to merge the branch from your fork into this project's default branch..
NodeJS is a big ecosystem with a variety of different use cases. The docker images for node are designed to provide the minimum for running core node. Additional dependencies (including dependencies for npm or yarn such as git) will not be included in these base images and will need to be included in descendent image.