Upgrade npm on Windows
First, ensure that you can execute scripts on your system by running the following command from an elevated PowerShell. To run PowerShell as Administrator, click Start, search for PowerShell, right-click PowerShell and select
Run as Administrator.
Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
Then, to install and use this upgrader tool, run the following command (also from an elevated PowerShell or cmd.exe). Note: This tool requires at least Node v8, please install an older version for older versions of Node.js.
npm install --global --production npm-windows-upgrade npm-windows-upgrade
Want to just install the latest version? Sure:
npm-windows-upgrade --npm-version latest
The tool will show you a list of all the published and available versions of npm (including pre-release and beta versions). Choose the one you want to install and let it do its thing!
Usage: npm-windows-upgrade [options]
-h, --help Output usage information -V, --version Output the version number -d, --no-dns-check Disable the internet connectivity test -e, --no-execution-policy-check Disable the PowerShell execution policy test -p, --no-spinner Disable the spinner animation -n, --npm-path <path> (Optional) If passed, npm will be upgraded in the specified location -v, --npm-version <version> (Optional) If passed, npm will be upgraded/downgraded to the specified version
If you have trouble with the script, consider adding parameters manually. A common issue is that the script fails to find npm (and therefore doesn't know where to install it) - in that case, pass the location manually.
npm-windows-upgrade --npm-path "C:\nodejs"
To manually specify a version to install, pass the
npm-windows-upgrade --npm-version 5.5.0
To override the internet connection check, pass
--no-dns-check. To disable the initial prompt, pass
To see debug output, set a
DEBUG environment variable (
Issues & Support
Please do report your issues on GitHub. There are a bunch of Windows versions, hundreds of different ways to install Node and npm, and it's likely that this script won't work with a few of them. If you run into trouble and need npm upgraded as soon as possible, please follow the manual instructions.
This tool was made with
Fix an Attempted Upgrade
Chances are that you attempted to upgrade npm before, it somehow failed, and you then went looking for this tool. If the tool fails to upgrade, it may be troubled by partial changes done during
npm install npm or
npm upgrade npm. In that case, you will have to completely uninstall Node:
- Uninstall Node.js (select
Uninstall, not the
- Go into
%programfiles%\nodejsand delete the entire folder.
- Edit your
PATHand remove everything that references npm (to do so, hit "Start" and search for "Environment Variables").
- Reinstall Node, then install this tool - and only use this tool to upgrade npm, do not attempt to run
npm install npm.
:memp: Used Chocolatey? If you used Chocolatey (https://chocolatey.org/) to install Node.js, be sure to check if npm is removed from the
choco\bindirectory by running the following command:
where.exe npm. Should it still be there, you will need to either
choco uninstall npmor delete the files from this bin directory.
Older Node.js Versions
- For Node versions lower than v8.0, please use
- For Node versions lower than v6.0, please use
- For Node versions lower than v4.0, please use
More Useful Node.js Stuff
Microsoft is working hard to make sure that our users have the best possible experience with Node.js. For a helpful set of content that makes it easier to avoid any potential gotchas, go check out our Node.js Guidelines - a collection of tips and advanced best practices!
grunt test to check your code against JSCS and JSHint. There's no formal coding guideline for the PowerShell pieces of this tool, but do write code that is commented and comprehensible.
MIT, please see
LICENSE for details. Copyright (c) 2015 - 2017 Felix Rieseberg.