Keywords: Eclipse | Uninstallation | Manual Deletion | p2 Bundle Pool | Windows Registry | Workspace Cleanup
Abstract: This article provides a comprehensive guide on how to completely uninstall Eclipse IDE across different operating systems. Since the Eclipse installer does not register installations in the Windows system registry, it cannot be removed through the standard uninstall programs in the Control Panel. The guide covers the complete process of manually deleting installation directories, cleaning up start menu and desktop shortcuts, managing p2 bundle pools, handling workspace data, and optionally removing Windows registry entries. It also explains the design philosophy behind Eclipse's lack of an automated uninstaller and provides methods for locating multiple Eclipse installations.
Why Eclipse Lacks an Automated Uninstaller
According to discussions on the official Eclipse forums, the design philosophy of the Eclipse installer is to automate tasks that were traditionally done manually, such as downloading, extracting Eclipse, and adding shortcuts. Consequently, these operations can also be undone manually. On Windows systems, Eclipse does not register installation information in the system registry, which is why it does not appear in the "Programs and Features" control panel.
Locating Eclipse Installations
The default installation path is in the ~/eclipse/ folder within the user's home directory. If you used the Eclipse installer for installation, you can locate specific installation paths by: launching the Eclipse installer, opening the "Bundle Pool" dialog (accessible via the menu in simple mode or a small button next to the bundle pool dropdown in advanced mode), clicking "Analyze Agent", and you will see a list of installation profiles. Double-clicking on any profile reveals the corresponding installation path.
You can also use file search tools to find files containing "eclipse" in their names to locate installation folders. However, note that Eclipse is a platform upon which other software can build applications, so there might be folders that resemble Eclipse IDE installations but are actually Eclipse-based applications you may wish to retain.
Quick Uninstallation Method for Eclipse
If you installed Eclipse manually (without using the Eclipse installer), simply delete the Eclipse directory to complete the uninstallation.
If you used the Eclipse installer for installation, follow these steps: First, delete the Eclipse directory along with all desktop and start menu shortcuts. Then, launch the Eclipse installer, open the "Bundle Pool" dialog, and click "Cleanup Agent" to remove unused bundles. If you have other Eclipse installations, this operation will not affect them.
In most cases, performing the above steps is sufficient, and you can stop further cleanup efforts.
Detailed Steps for Complete Eclipse Uninstallation
If you wish to remove Eclipse entirely without leaving any traces, manually delete the following:
- All desktop and start menu shortcuts
- All installation directories (e.g.,
~/eclipse/photon/) - The p2 bundle pool (often shared with other Eclipse installations)
The installer's "Bundle Pools" menu entry lists the locations of all bundle pools. If there are other Eclipse installations on your system, use the "Cleanup Agent" function to remove unused bundles. If there are no other Eclipse installations, you can delete the entire bundle pool directory (default is ~/p2/).
If you also want to completely remove the Eclipse installer, delete the installer's executable and the ~/.eclipse/ directory.
Depending on the type of development work you conducted with Eclipse, you may need to delete additional directories. For instance, if you used Maven, the ~/.m2/ directory contains the Maven cache and settings (shared with Maven CLI and other IDEs). If you developed Eclipse plugins, test runs might have created JUnit workspaces located next to your Eclipse workspace. Similarly, other build tools and development environments used within Eclipse could have created analogous directories.
Deleting Projects and Workspace Data
If you wish to delete projects and workspace metadata, you need to delete the workspace(s). The default workspace location is ~/workspace/. You can also search for the .metadata directory to find all Eclipse workspaces on your machine.
If you manage projects with Git, these projects are typically not saved in the workspace but in the ~/git/ directory.
Windows Registry Cleanup (Optional)
Although Eclipse is not "installed" like a regular Windows application, it still writes some entries to the system registry. If you search the Registry for "eclipse", you might find URL handler entries such as eclipse+command, eclipse+mpc, or eclipse+installer. These entries are used for functions like installing Eclipse plugins from the browser.
You may also see other entries in your system, which are likely created by Windows itself rather than Eclipse (e.g., entries in the list of recently used executables). Whether to delete these entries is a matter of personal preference. Technically, deleting them usually does not cause system issues, but registry "cleaning" is a controversial topic, and caution is advised.