marcaureln/volta repository overview

⁠Volta Docker Image

This repository contains Docker images for the Volta⁠ JavaScript tool manager.

⁠Available tags and respective Dockerfile links

• latest, latest-bookworm, 2.0.1, 2.0.1-bookworm⁠
• latest-bullseye, 2.0.1-bullseye⁠
• latest-slim, latest-bookworm-slim, 2.0.1-slim, 2.0.1-bookworm-slim⁠
• latest-bullseye-slim, 2.0.1-bullseye-slim⁠

This list won't be updated as frequently as the tags. Check this page⁠ for all available tags.

⁠Supported architectures

This image is built for amd64 and arm64.

⁠Supported Node.js versions

All Node.js versions supported by Volta are supported by this image. Always make sure to pin a Node.js version in your package.json file. Learn more about pinning Node.js versions here⁠.

⁠What is Volta?

To quote their website:

I can't say it better than that.

⁠How to use this image

Create a Dockerfile in your project directory with the following content:

# You can specify the version of volta you want to use by changing the tag
FROM marcaureln/volta:latest

# Make sure to have a Node.js version pinned in your package.json (use `volta pin node` to pin a version)
COPY package.json ./
COPY package-lock.json ./

# Install dependencies using the pinned npm or yarn version
RUN npm install

# Copy the rest of your application
COPY . .

# Run your application
CMD ["npm", "start"]

Then build the Docker image:

docker build -t my-nodejs-app .

And run it:

docker run --rm -it my-nodejs-app

⁠Image Variants

The marcaureln/volta images come in several flavors. The latest tag is always the latest version of Volta with the latest stable Debian version.

⁠marcaureln/volta:<version>

The <version> refers to the Volta version you want to use. Version >= 2.0.0 are supported. When using this tag, the image will be based off of the latest stable Debian version.

⁠marcaureln/volta:<version>-<flavor>

The <flavor> refers to the Debian version you want to use. The tags are based off of Debian's buildpack-deps images⁠. The following flavors are available: bookworm, bullseye. Thereby, the following tags are available: <version>-bookworm, <version>-bullseye.

⁠marcaureln/volta:<version>-<flavor>-slim

The slim variant is based off of Debian's slim images⁠. The same flavors are available: bookworm, bullseye. Thereby, the following tags are available: <version>-bookworm-slim, <version>-bullseye-slim.

⁠Why is there no Alpine variant?

Volta does not support Alpine Linux yet. See https://github.com/volta-cli/volta/issues/473⁠ for more information.

⁠Acknowledgements

This Docker image is inspired by Michal Bryxí's article⁠.

Special thanks to the Volta⁠ team for creating such a great tool.

⁠License

This project is licensed under the MIT license⁠.