Node.js on Windows Nano Server

This project brings Node.js (version 4 to 25; argon to krypton) on Microsoft Windows Nano Server base image.

Note: Version 5 is not available due to unavailability of the upstream.

Tags

• latest 25 25-ltsc2025
• krypton 24 24-ltsc2025
• jod jod-ltsc2025 22 22-ltsc2025
• iron iron-ltsc2025 20 20-ltsc2025
• hydrogen hydrogen-ltsc2025 18 18-ltsc2025
• gallium gallium-ltsc2025 16 16-ltsc2025
• fermium fermium-ltsc2025 14 14-ltsc2025
• erbium erbium-ltsc2025 12 12-ltsc2025
• dubnium dubnium-ltsc2025 10 10-ltsc2025
• carbon carbon-ltsc2025 8 8-ltsc2025
• boron boron-ltsc2025 6 6-ltsc2025
• argon argon-ltsc2025 4 4-ltsc2025

Full list of tags avilable at both GitHub Container registry and Docker Hub Container registry.

Usage

This project is intended to be used as base image for other Node-based projects. An example Dockerfile:

FROM ghcr.io/amitie10g/node-nanoserver:krypton

COPY . C:\\Users\\ContainerUser\\app
RUN npm install --omit=dev

ENTRYPOINT ["npm", "start"]

If you need to install system-wide software, you need to set USER as ContainerAdministrator. Afterward, you need to change it back to ContinerUser.

If you want to use it within GitHub Actions, prefer the GitHub Container registry: ghcr.io/amitie10g/node-nanoserver

Building

Containers for this project has been built using GitHub Actions for automated weekly builds from 4 to 24 under Windows Nano Server ltsc2025, ltsc2022 and ltsc2019. If you need other versions of Windows, follow this instructions.

docker build -t <tag> --build-arg NODE_VER=<node version> --build-arg BASE_IMG=<base image> --build-arg CONT_VER=<container version> .

Where,

• NODE_VER is used to download Node from https://nodejs.org/dist/v${NODE_VER}/node-v${NODE_VER}-win-x64.zip
• BASE_IMG is the base image, either windows/nanoserver or powershell
• CONT_VER is the tag available for each base image. For a full list of available tags, consult the respective page of the base images provided (links above).

Licensing

• Everything in this repo is released into the Public domain (the Unlicense)
• Node.js is licensed under the MIT License.
• Microsoft Windows container images usage is subjected to the Microsoft EULA
• Microsoft PowerShell is licensed under the MIT License.