Versions v5.10.1, v4.4.3, v0.12.13, v0.10.44, and io.js – built on Alpine Linux.
All versions use the one mhart/alpine-node repository,
but each version aligns with the following tags (ie, mhart/alpine-node:<tag>):
- Full install built with npm:
latest,5,5.10,5.10.1– 36.84 MB (npm 3.8.5)4,4.4,4.4.3– 36.8 MB (npm 2.15.3)0.12,0.12.13– 32.89 MB (npm 2.15.3)0.10,0.10.44– 28.33 MB (npm 2.15.3)
- Base install with node built as a static binary with no npm:
base,base-5,base-5.10,base-5.10.1– 27.52 MBbase-4,base-4.4,base-4.4.3– 27.75 MBbase-0.12,base-0.12.13– 24.14 MBbase-0.10,base-0.10.44– 18.31 MB
Major io.js versions are tagged too.
$ docker run mhart/alpine-node node --version
v5.10.1
$ docker run mhart/alpine-node:4 node --version
v4.4.3
$ docker run mhart/alpine-node npm --version
3.8.5
$ docker run mhart/alpine-node:base node --version
v5.10.1
$ docker run mhart/alpine-node:3 iojs --version
v3.3.1
$ docker run mhart/alpine-node:base-0.10 node --version
v0.10.44
If you don't have any native dependencies, ie only depend on pure-JS npm
modules, then my suggestion is to run npm install locally before running
docker build (and make sure node_modules isn't in your .dockerignore) –
then you don't need an npm install step in your Dockerfile and you don't need
npm installed in your Docker image – so you can use one of the smaller
base* images.
FROM mhart/alpine-node:base
# FROM mhart/alpine-node:base-0.10
# FROM mhart/alpine-node
WORKDIR /src
ADD . .
# If you have native dependencies, you'll need extra tools
# RUN apk add --no-cache make gcc g++ python
# If you need npm, don't use a base tag
# RUN npm install
EXPOSE 3000
CMD ["node", "index.js"]
As Alpine Linux uses musl, you may run into some issues with environments expecting glibc-like behaviour (for example, Kubernetes). Some of these issues are documented here:
Inspired by: