Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

nvm

github.com

  • Free plan
  • Open source
  • Windows
  • macOS
  • Linux
  • Self-hosted
8.1 Club score Visit github.com

What nvm is

nvm is a command-line tool for installing and using different Node.js versions. It is free, MIT-licensed, and designed to be installed for an individual user and run in each shell session. Users can install particular versions, switch between them, and assign aliases such as a default version. LTS aliases and commands help users find, install, and use long-term support releases. Projects can specify a version in an .nvmrc file, and documented shell snippets can enable automatic switching. During installation, nvm can reinstall global npm packages from another installed Node.js version. It can also install a previously downloaded or cached version without network access using the --offline flag. The project documents Docker use, including an example for CI/CD jobs. It supports POSIX-compliant shells such as sh, dash, ksh, zsh, and bash. Windows use may work through WSL, or with Git Bash or Cygwin depending on the environment. Fish is not supported, and only the latest nvm version is supported.

Who it suits

nvm suits developers who need to manage Node.js versions from the command line, including across projects with different version requirements. It may also suit teams using Docker or CI/CD workflows.

Good to know, and what to watch

  • Install and switch between specific Node.js versions.
  • Project versions can be specified with .nvmrc.
  • Supports LTS aliases and commands.
  • Cached versions can be installed offline.
  • Global npm packages can be reinstalled during installation.
  • Fish shell is not supported.
  • Windows use depends on WSL or other environments.
  • Only the latest nvm version is supported.

nvm

Free

Free plan

The verdict

nvm provides per-user, per-shell Node.js version management, with project pinning, LTS support, and offline installation. Check shell compatibility first, particularly if you use Fish or Windows without WSL.

What the maker publishes

Aliases
Users can create aliases such as default or custom names for Node versions. source
API and SDKs
The README documents a sourced shell command interface and environment variables; it does not describe a hosted HTTP API or SDK. source
Automatic switching
Automatic directory switching is documented as user-added bash or zsh hooks rather than built into the core command. source
Core installation
Users can install the latest Node release, a specific version, or source builds with nvm install. source
Docker and CI
The README documents using nvm in Docker, including an example for CI/CD jobs. source
Docker and CI
The documentation provides Dockerfile patterns using BASH_ENV and a separate CI/CD container example. source
Documentation depth
The README includes installation, Docker, CI/CD, shell hooks, mirrors, offline mode, environment variables, testing, troubleshooting and uninstall guidance. source
Execution helpers
nvm run and nvm exec run commands with a selected Node version without permanently changing the surrounding shell. source
Extensibility
Mirror URLs, authorization headers and several NVM_* environment variables can customize downloads and installation behavior. source
Fish limitation
The project does not natively support Fish and suggests wrappers or alternative managers. source
Independent mirror status
SourceForge identifies its nvm page as an exact mirror and states it is not affiliated with the project. source
Independent project snapshot
Hysen Labs recorded 95,544 GitHub stars, 10,530 forks, Shell as the main language and MIT licensing on October 15, 2026. source
Installation model
It is designed to be installed per user and invoked per shell. source
Integrations
Documented integrations include Docker, Ansible, zsh plugins, bash completion and optional nvshim shims. source
Latest release
The release page lists v0.40.7 as a signed release adding concurrent-install serialization and safer download handling. source
License
The repository identifies the project as MIT licensed. source
License
nvm is distributed under the MIT License, permitting use, modification, distribution and sale subject to retaining notices. source
Limit: Fish shell
A Stack Overflow answer explains that nvm.sh cannot be sourced directly by Fish because Fish is not POSIX-compatible. source
Limit: native Windows
Independent comparison coverage says the original nvm does not work natively on Windows and requires the separate nvm-windows project. source
Limit: shared machines
Microsoft warns that per-user symbolic-link behavior can make nvm unsuitable for shared developer boxes and multi-agent build servers. source
Limit: shell startup speed
Marco Orta measured about 405 ms to load nvm and about 1,003 ms to switch versions in his six-version WSL2 test. source
LTS support
It supports installing, using, and listing Node.js long-term support versions through LTS aliases and commands. source
LTS support
The command set includes aliases and workflows for installing and selecting Node.js long-term-support releases. source
Offline installation
Recent releases add nvm install --offline to install a version from the local cache without network access. source

Checked against the maker's pages on 15 Oct 2026.