# nvm-windows Documentation

> NVM for Windows documentation — installers, features, configuration, and enterprise deployment.

## Install

- [Installers & Packages](/install/installers.md): NVM for Windows offers community and certified builds on amd64 (x64) and arm64 devices. See Choosing an Edition to understand which is right for you.

### Enterprise Deployment

- [Deploy with Active Directory](/install/enterprise/ad.md): What you'll need:
- [Deploy with Microsoft Intune](/install/enterprise/intune.md): Deploy NVM for Windows with the pre-built files found in the NVM for Windows download in the customer portal. No file server required. The installer runs as System and accepts the EULA automatically (ACCEPT_EULA=1).
- [Requirements](/install/enterprise/requirements.md): |Requirement|Guidance|
- [Build from Source](/install/source.md): Most users should install a prebuilt package instead — see Installers.
- [Uninstall](/install/uninstall.md): Uninstalling NVM for Windows (the application) from the computer is different from nvm uninstall, which only removes installed Node.js versions while leaving NVM for Windows installed.

## Features

- [Operating Modes](/features/modes.md): NVM for Windows operates in one of two modes: link or shim. These modes determine how Node.js, dependency managers, and global modules are executed. The operating mode can be switched at any time.
- [What's new in v2](/features/newv2.md): High Level
- [Windows Apps Integration](/features/windows-apps.md): Installed versions of Node.js are visible in the Windows Apps screen. They can be uninstalled directly from there too.
- [Event Logging](/features/log.md): Critical events, such as installations, configuration changes, and security events are logged natively, available in Windows Event Viewer. This allows for clear organization observability and auditing using tools most organizations already familiar with.
- [Desktop Notifications](/features/notifications.md): NVM for Windows uses native desktop notifications with the Windows Notification Center. Missed notifications stay in the Notification Center until acknowledged. Personal notification preferences are honored.
- [Windows Registry Integration](/features/windows-registry.md): As of v2.0.0, settings and preferences are stored in the registry under user keys. These can be modified with the nvm config command. See Basic Configuration for the full preference list.
- [Download Mirrors](/features/mirrors.md): NVM for Windows downloads Node.js archives from one or more Node mirrors, and can fall back to one or more npm registry URLs in shim mode. Set these with nvm config (or machine policy on certified fleets).
- [Version Firewall + Author Mirror](/features/author-mirror.md): Governance builds can limit which Node.js versions install via a local firewall (static allow/block lists) and Author Software's policy-aware Node.js mirror at https://mirror.author.io/runtime/nodejs (lifecycle rules such as blocking end-of-life releases).
- [Local Installations](/features/local-installations.md): Local installations let NVM for Windows install Node.js from archives already on disk instead of (or before) contacting a download mirror. Use this for air-gapped hosts, shared lab mirrors, or any environment where outbound downloads are blocked or undesirable.
- [Download Cache](/features/cache.md): NVM for Windows can keep downloaded Node.js archives on disk so later installs skip the network when a matching archive is already present. Manage that store with nvm cache, or turn automatic saving on with cache_downloads.

## Configuration

- [Basic Configuration](/cfg/core.md): User preferences live in the Windows registry. Manage them with nvm config (alias: nvm cfg).

### Enterprise policy

- [Administrative Templates (Intune & GPO)](/cfg/ad.md): NVM for Windows certified governance builds come with ADMX/ADML templates. Use them in on-premises Group Policy or Microsoft Intune configuration profiles.
- [Registry Policy Reference](/cfg/registry.md): This reference contains the registry keys and values used to manage, secure, and configure NVM for Windows in enterprise environments.

## Commands


### install

- [native-tools](/command/install/native-tools.md): Run install_tools.bat from the newest installed Node.js version that includes it.
- [uninstall](/command/uninstall.md): Uninstall one or more versions of Node.js.

### use

- [lts](/command/use/lts.md): Use the most recent LTS release, or a named LTS line.
- [latest](/command/use/latest.md): Use the highest semantic version among installed versions (not the newest remote release).
- [last](/command/use/last.md): Switch back to the previously active default version.
- [shim](/command/use/shim.md): Switch NVM to shim operating mode.
- [link](/command/use/link.md): Switch NVM to link operating mode.
- [pin](/command/pin.md): Create or update a run-command file (for example, .nvmrc).

### list

- [releases](/command/list/releases.md): List downloadable Node.js releases from configured mirrors.
- [cached](/command/list/cached.md): List Node.js versions present in the download cache.

### alias

- [add](/command/alias/add.md): Add or update a named alias for a Node.js version.
- [list](/command/alias/list.md): List configured version aliases.
- [remove](/command/alias/remove.md): Remove one or more version aliases.
- [default](/command/default.md): Show the current default Node.js version.
- [env](/command/env.md): Display environment details used by NVM for Windows.

### cache

- [add](/command/cache/add.md): Download and cache Node.js archives without installing.
- [list](/command/cache/list.md): List cache stores and their files.

#### remove

- [version](/command/cache/remove/version.md): Remove cached Node.js download archives. Default when you pass version arguments to nvm cache remove.
- [metadata](/command/cache/remove/metadata.md): Remove cached metadata files.
- [all](/command/cache/remove/all.md): Clear both metadata and versions caches.

### config

- [list](/command/config/list.md): List effective NVM configuration values.
- [get](/command/config/get.md): Get one or more configuration values.
- [set](/command/config/set.md): Set one or more configuration values.
- [reset](/command/config/reset.md): Reset configuration option(s) to their defaults.
- [docs](/command/config/docs.md): Print built-in documentation for every configuration option.
- [on](/command/on.md): Enable Node.js management through NVM.
- [off](/command/off.md): Temporarily stop managing Node.js through NVM.
- [doctor](/command/sync-doctor.md): Detect and fix common NVM for Windows issues.
- [upgrade](/command/sync-upgrade.md): Upgrade NVM for Windows.
- [Permissions](/permissions.md): No special permissions are required to install or operate NVM for Windows. Users may want to leverage special permissions in select circumstances though.

## Guides

- [Choosing an Edition](/guide/builds/.md): This guide details the differences between NVM for Windows community builds and certified builds, to help readers choose the option best suited for them.
- [Version Resolution](/guide/version-resolution.md): NVM for Windows accepts several ways to identify a Node.js version. Depending on the
- [Command Workflows](/guide/command-workflows.md): This guide explains common end-to-end CLI workflows.
- [Air-gapped Installations](/guide/air-gapped-installations.md): This guide walks through installing Node.js with NVM for Windows when the target machine cannot reach public download mirrors (or must not).
- [Troubleshooting](/troubleshooting.md): | Symptom | Likely Cause | Verify | Fix |
- [index](/.md)

## Other Pages

- /markdown-page
- /tags
- /tags/native-integration
- /tags/sync