nvm
github.com
- Free plan
- Open source
- Windows
- macOS
- Linux
- Self-hosted
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.
Plans
Every plan and pricenvm
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.