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

⚠ 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.

Download and run the latest installer from the Releases page.

Download and run the latest installer from the Releases page.

Type nodeswap in your terminal for help.

• 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 an installed version. The version can be latest, a specific version like 22.6.0, or a fuzzy version like 22.6 or 22.
• nodeswap prev / nodeswap last — Switch to the previously installed version of Node.js.
• nodeswap file — Use or create a .nodeswap file to manage Node.js version for the current directory.

⚠ 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.

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.

• Please report in the Issue Tracker.

MIT