NodeSwap

NodeSwap is a Windows-only version manager for Node.js, similar to NVM.

Installing and Updating

⚠ Prerequisites:

• Minimum of .NET 8.0

  • There's a good chance you already have this on modern Windows.
  • If not, download & install at least .NET 8.0.

• Existing Node.js installations:

  • Be sure to uninstall any existing Node.js installations.
  • Remove %AppData%\npm to prevent global module conflicts.

Install NodeSwap

Download and run the latest installer from the Releases page.

Upgrade NodeSwap

Download and run the latest installer from the Releases page.

Usage

Type nodeswap in your terminal for help.

Commands:

• nodeswap — Provides an overview of commands
• nodeswap list — List the Node.js installations.
• nodeswap avail [<min>] — List the versions available for download. A minimum version can be specified to reduce the amount of output.
• nodeswap install <version> — The version can be latest, a specific version like 22.6.0, or a fuzzy version like 22.6 or 22.
• nodeswap uninstall <version> — The version must be specific like 22.6.0.
• nodeswap use <version> — Switch to a specific version. Must be specific like 22.6.0.

⚠ Admin privileges:

NodeSwap uses a symlink to point your CLI to the active Node.js version. On Windows, creating symlinks requires admin privileges. When swapping Node.js versions, the use command will prompt for administrator access if your terminal isn't already elevated.

How-to

Change where NodeSwap stores Node.js installations:

NodeSwap utilizes an environment var named NODESWAP_STORAGE. Simply update it with a new path.

Be sure the path actually exists. NodeSwap does not create it for you.

Issues & Feature Requests

• Please report in the Issue Tracker.

License

MIT