Miss any of our Open RFC calls?Watch the recordings here! »

@jchip/nvm

1.3.1 • Public • Published

@jchip/nvm

A universal node.js version manager for Windows (no admin) and Unix.

  • Install is simple with a PowerShell script on Windows, or a bash script on Unix.

  • No admin required on Windows to install or use.

  • A linked system wide version that can be changed any time.

  • Change to any version independently in a terminal any time.

Table Of Contents

Installing Windows nvm using PowerShell

You don't need admin rights to install or use, only the permission to execute PowerShell scripts.

Tested on Windows 10, 8.1, and 7. Windows 7 requires PowerShell updates, see update instructions.

To install, start a Windows PowerShell and copy and paste one of the scripts below into the shell terminal and press enter.

  • This will install nvm and current LTS Node.js (v12.13.0) to directory nvm under your home specified by $Env:USERPROFILE.

  • If you want to install this under another directory, then set it with the param -nvmhome.

  • If you don't set it, then $Env:NVM_HOME will be checked, and if non-existent, then a Directory Browser dialog will be opened for you to create and choose a directory.

Video Demo of upgrading Windows 7 to PowerShell 5.1 and then installing this

You can retrieve the install script from multiple sources. Listed below are three options for you to choose from in case one of them is down.

Installing from github.com

Retrieve install script from github.com directly:

cd $Env:USERPROFILE;
Invoke-WebRequest https://raw.githubusercontent.com/jchip/nvm/v1.3.1/install.ps1 -OutFile install.ps1;
.\install.ps1 -nvmhome $Env:USERPROFILE\nvm;
del install.ps1

Installing from unpkg.com

Retrieve install script from unpkg.com:

cd $Env:USERPROFILE;
Invoke-WebRequest https://unpkg.com/@jchip/nvm@1.3.1/install.ps1 -OutFile install.ps1;
.\install.ps1 -nvmhome $Env:USERPROFILE\nvm;
del install.ps1

Installing from jsdelivr.net

Retrieve install script from jsdelivr.net:

cd $Env:USERPROFILE;
Invoke-WebRequest https://cdn.jsdelivr.net/npm/@jchip/nvm@1.3.1/install.ps1 -OutFile install.ps1;
.\install.ps1 -nvmhome $Env:USERPROFILE\nvm;
del install.ps1

Windows 7 Updates

PowerShell version 4+ is required.

For Windows 7, you can update it to version 5.1 with the following instructions:

  1. Go to https://www.microsoft.com/en-us/download/details.aspx?id=54616
  2. Click Red Download button
  3. Download Win7AndW2K8R2-KB3191566-x64.zip or Win7-KB3191566-x86.zip for 32-bit
  4. Unzip the file
  5. Run the package Win7AndW2K8R2-KB3191566-x64.msu or Win7-KB3191566-x86.msu for 32-bit

After it's completed and rebooted, launch PowerShell and type $PSVersionTable to check.

PSVersion should be something like 5.1.#####.####

Video Demo of upgrading Windows 7 to PowerShell 5.1 and then installing this

Troubleshooting

Running scripts disabled

If you get the error:

install.ps1 cannot be loaded because running scripts is disabled on this system.

Then you need to set execution policy for PowerShell to RemoteSigned with the command:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

See this StackOverflow question for details.

You need to keep this policy if you want to use nvm in PowerShell to switch node.js versions.

No PowerShell

If you absolutely can't have PowerShell, then please submit an issue. I will make a list of manual steps to install this, and if there's interest, then I will make a standalone installer using 7zip.

Installing Unix nvm

Because this is implemented in node.js, it happens to work on Unix also. It just need a different install script using bash.

To retrieve and run the install script, provided below are three options for you to choose from in case one of them is down.

Please pick one and then copy and paste it into a bash terminal to run.

Installing from github.com

Retrieve the install script from github.com:

Using cURL and the install script:

NVM_HOME=~/nvm curl -o- https://raw.githubusercontent.com/jchip/nvm/v1.3.1/install.sh | bash

or wget:

NVM_HOME=~/nvm wget -qO- https://raw.githubusercontent.com/jchip/nvm/v1.3.1/install.sh | bash

Installing from unpkg.com

Retrieve the install script from unpkg.com:

Using cURL and the install script:

NVM_HOME=~/nvm curl -o- https://unpkg.com/@jchip/nvm@1.3.1/install.sh | bash

or wget:

NVM_HOME=~/nvm wget -qO- https://unpkg.com/@jchip/nvm@1.3.1/install.sh | bash

Installing from jsdelivr.net

Retrieve the install script from jsdelivr.net:

Using cURL and the install script:

NVM_HOME=~/nvm curl -o- https://cdn.jsdelivr.net/npm/@jchip/nvm@1.3.1/install.sh | bash

or wget:

NVM_HOME=~/nvm wget -qO- https://cdn.jsdelivr.net/npm/@jchip/nvm@1.3.1/install.sh | bash

Usage

Usage: nvm <command> [options]

Commands:
  nvm install <version>    install the given version of Node.js
  nvm uninstall <version>  uninstall the given version of Node.js
  nvm use <version>        use the given version of Node.js in current shell
  nvm stop                 undo effects of nvm in current shell [aliases: unuse]
  nvm link <version>       permanently link the version of Node.js as default
  nvm unlink               permanently unlink the default version
  nvm ls                   list all the installed Node.js versions
  nvm ls-remote            list remote versions available for install
  nvm cleanup              remove stale local caches

Options:
  --proxy, -p                   Set network proxy URL                   [string]
  --verifyssl, --ssl, --no-ssl  Turn on/off verify SSL certificate
                                                       [boolean] [default: true]
  --latest                      Match latest version to uninstall
  --version, -V, -v             Show version number
  --help, -?, -h                Show help. Add a command to show its help
                                                                        [string]

envs:

  NVM_PROXY - set proxy URL
  NVM_VERIFY_SSL - (true/false) turn on/off verify SSL certs

Examples:

    nvm install 12.8
    nvm use 12
    nvm uninstall 12.4

doc: https://www.npmjs.com/package/@jchip/nvm

Environments

These env flags can be set:

name values description
NVM_PROXY string An URL to a network proxy
NVM_VERIFY_SSL true/false turn on/off node.js verify SSL certificates

License

MIT

Install

npm i @jchip/nvm

DownloadsWeekly Downloads

11

Version

1.3.1

License

MIT

Unpacked Size

813 kB

Total Files

11

Last publish

Collaborators

  • avatar