Skip to content

volta uninstall

The volta uninstall command allows you to remove any global package that has been installed with volta install. It has the following syntax:

bash
Uninstalls a tool from your toolchain

USAGE:
    volta uninstall [FLAGS] <tool>

FLAGS:
        --verbose    Enables verbose diagnostics
        --quiet      Prevents unnecessary output
    -h, --help       Prints help information

ARGS:
    <tool>    The tool to uninstall, e.g. `node`, `npm`, `yarn`, or <package>

Note As of Volta 0.9.0, you can also uninstall a package using your package manager with npm uninstall --global or yarn global remove

Examples

Uninstalling Node.js

bash
# Uninstall Node
volta uninstall node

Uninstalling Node removes it as your default version, but doesn't remove the binary from Volta's cache. This means that pinned projects will still be able to use the specified Node version.

Uninstalling Package Managers

bash
# Uninstall npm
volta uninstall npm

# Uninstall yarn
volta uninstall yarn

# Uninstall pnpm
volta uninstall pnpm

Uninstalling Global Packages

bash
# Uninstall TypeScript
volta uninstall typescript

# Uninstall ESLint
volta uninstall eslint

What Happens When You Uninstall

When you uninstall a tool with volta uninstall:

  1. The tool is removed from your default toolchain
  2. Any global shims for that tool are removed from your PATH
  3. The actual tool remains in Volta's cache for use by projects that have pinned versions

Uninstalling vs Removing from Cache

volta uninstall only removes the tool from your default toolchain. The tool's binaries remain in Volta's cache to be used by projects that have pinned that specific version.

If you want to completely remove a tool from your system, including from Volta's cache, you would need to:

  1. Uninstall it with volta uninstall <tool>
  2. Remove it from Volta's cache directory (typically in ~/.volta/tools/)

Released under the BSD 2-Clause License.