Cleanly Uninstall Software with Chocolatey Guide

Posted on by

You’ve used Chocolatey to effortlessly install software on your Windows machine – a quick command and your favorite applications are ready to go. But what happens when you no longer need a program? Just like installation, removing software cleanly is crucial to maintain a tidy system, avoid leftover files, and prevent potential conflicts down the line. This guide will show you how to uninstall software with Chocolatey using a simple command, making the removal process as smooth and clean as the installation.

Why Use Chocolatey for Uninstalling?

While Windows has its built-in “Add or Remove Programs” feature, and many applications come with their own uninstallers, these methods can sometimes leave behind registry entries, configuration files, or empty folders. Over time, this digital clutter can accumulate. Chocolatey offers a more consistent and often cleaner approach to software removal.

When you uninstall software with Chocolatey, it leverages package-specific uninstall scripts provided by the package maintainers. These scripts are designed to remove the software thoroughly, aiming to clean up associated files and registry entries more effectively than generic methods. This consistency means you use the same simple command regardless of the software you’re removing, which is excellent for scripting and automated removal tasks.

Step 1: Identify the Software (Find the Package ID)

To uninstall a program using Chocolatey, you need its exact Package ID. This is the short name you used when you installed it (e.g., vlc, notepadplusplus, googlechrome).

If you’ve forgotten the Package ID for software installed via Chocolatey, you can easily get a list of all locally installed packages. Open PowerShell or Command Prompt (you don’t need Administrator privileges for just listing) and run the following command:

choco list --localonly

This command will output a list of all packages currently managed by your local Chocolatey installation, showing their Package ID and version number. Look through this list to find the precise ID for the software you want to remove.

For example, the output might look something like this (yours will vary):

chocolatey v1.4.0
googlechrome 108.0.5359.124
notepadplusplus 8.4.8
vlc 3.0.18

4 packages installed.

In this example, the Package IDs are googlechrome, notepadplusplus, and vlc. Make sure you get the ID exactly right, as the uninstall command is case-sensitive for the package name.

Step 2: Execute the Uninstall Command

Once you have the correct Package ID, you’re ready to perform the uninstallation. The core command for this is choco uninstall.

The purpose of this command is to initiate the removal process for the specified package by running its dedicated uninstall script. The basic syntax is:

choco uninstall [packageID]

Crucial Note: Uninstalling software often requires system-level permissions to modify files in Program Files, remove registry entries, and stop services. Therefore, you must run the choco uninstall command from an Administrator PowerShell or Command Prompt window. Right-click on your terminal application icon and select “Run as administrator”. If you don’t run as Administrator, the uninstall will likely fail with permission errors.

Here are some examples using the Package IDs we found earlier:

To uninstall VLC media player:

choco uninstall vlc

To uninstall Notepad++:

choco uninstall notepadplusplus

After executing the command, Chocolatey will download and run the uninstall script for that package. You’ll see progress messages in the terminal indicating what steps are being taken. Depending on the package, you might see the application’s own uninstaller window appear, or the process might happen silently in the background. By default, Chocolatey might ask for confirmation before proceeding; type Y and press Enter to confirm, or use the -y flag (explained below) for automated removal.

Uninstalling Multiple Packages

One of the great benefits of using a package manager like Chocolatey is the ability to manage multiple pieces of software with a single command. To remove several programs at once, simply list their Package IDs separated by spaces after the choco uninstall command:

choco uninstall packageID1 packageID2 packageID3

For instance, to uninstall both VLC and Notepad++ with one command (remembering to run this as Administrator):

choco uninstall vlc notepadplusplus

If you want to perform the uninstallation without any interactive prompts (useful for scripting or automated software maintenance), you can add the -y flag. This tells Chocolatey to automatically confirm any prompts. Use this with caution, especially if you’re unsure about the uninstall process for a specific package:

choco uninstall vlc notepadplusplus -y

Verifying Successful Uninstallation

After running the choco uninstall command, how can you be sure the software is gone? Here are a few ways to verify:

  • Check your Start Menu or desktop for the application’s shortcuts.
  • Go to Windows Settings > Apps > Apps & features (or the old “Add or Remove Programs” in Control Panel) and see if the software is still listed there.
  • Run the choco list --localonly command again. The uninstalled package should no longer appear in the list of locally installed Chocolatey packages.
choco list --localonly

If the package is no longer in the Chocolatey list and isn’t found in Windows’ installed apps list, the uninstallation was successful.

Troubleshooting Common Uninstall Issues

Sometimes, an uninstall might not go as planned. Here are a few common issues and what to check:

  • Not Running as Administrator: As mentioned, most uninstalls require elevated permissions. Ensure your PowerShell or Command Prompt window says “Administrator” in the title bar.
  • Incorrect Package ID: Double-check the Package ID using choco list --localonly. A typo will prevent the command from finding the software.
  • Software is Currently Running: If the application you’re trying to uninstall is open or running in the background, the uninstall process might fail or prompt you to close it. Close the application completely before attempting to uninstall.
  • Uninstall Script Failure: Occasionally, the package’s uninstall script itself might encounter an issue. This is less common but can happen. Chocolatey will usually report an error code. In such rare cases, you might need to investigate the specific package or resort to manual cleanup as a last resort, though Chocolatey aims to avoid this complexity.
  • Need for System Restart: Some programs require a system restart to complete the removal of all files and registry entries. Chocolatey might inform you if a reboot is recommended or necessary.

Conclusion

Using the choco uninstall command provides a straightforward and often cleaner way to remove software installed via Chocolatey. By leveraging package-specific scripts, it helps reduce leftover files and registry entries compared to generic removal methods. Finding the Package ID is simple with choco list --localonly, and the uninstall command is easy to use, even for removing multiple programs at once.

By using Chocolatey for both installation and uninstallation, you gain a consistent, command-line driven approach to managing your software lifecycle on Windows. Give choco uninstall a try the next time you need to remove a program!