To uninstall Eclipse on a Mac, you need to delete the Eclipse application folder, its configuration and workspace directories, and any launch agents or symlinks. This guide covers the complete removal process so no traces remain, including hidden files that can cause issues if you reinstall later.
What Eclipse Leaves Behind on macOS
Eclipse is a Java-based IDE that does not use the standard macOS drag-to-Trash installer. When you download Eclipse, you get a folder named eclipse that contains the app launcher, plugins, and configuration files. Dragging that folder to the Trash removes the program itself, but Eclipse also stores user data and preferences in your home directory and in the system’s caches. These leftover files are not harmful by themselves, but they can cause problems if you install a new version and it picks up old corrupted settings, or if you simply want a clean system.
The main locations where Eclipse stores data on macOS are:
/Applications/eclipseor wherever you placed the downloaded folder~/eclipse-workspace– the default workspace containing your projects~/.eclipse– configuration and plugin data for the current user~/Library/Caches/org.eclipse.*– cached files~/Library/Preferences/org.eclipse.*– preference files~/Library/Application Support/Eclipse– support files in newer versions
If you installed Eclipse via Homebrew (e.g., brew install --cask eclipse-java), the removal steps differ slightly because Homebrew tracks the installation. In that case, running brew uninstall --cask eclipse-java removes the app, but the same user-level folders still remain.
Step-by-Step Uninstall Process
Follow these steps to fully remove Eclipse and its associated files. You can skip step 3 if you want to keep your projects, but for a complete uninstall, back them up first.
- Quit Eclipse – Make sure Eclipse is not running. Press
Cmd+Qor right-click the dock icon and choose Quit. - Delete the Eclipse application folder – Open Finder, go to the folder where you placed Eclipse (usually
/Applications), and drag theeclipsefolder to the Trash. If you installed via Homebrew, runbrew uninstall --cask eclipse-javain Terminal instead. - Back up and remove your workspace – Your projects are typically in
~/eclipse-workspace. If you need them, copy that folder to an external drive. Then delete it from its original location. - Remove hidden configuration folders – Open Terminal and run the following commands to delete the user-level Eclipse data. Be careful: these commands are specific to Eclipse and will not affect other software.
rm -rf ~/.eclipse rm -rf ~/Library/Caches/org.eclipse.* rm -rf ~/Library/Preferences/org.eclipse.* rm -rf ~/Library/Application\ Support/Eclipse
- Check for launch agents – Some Eclipse plugins (like the Eclipse Installer) may create a LaunchAgent. Look in
~/Library/LaunchAgentsfor any file witheclipsein the name and delete it. - Empty the Trash – Right-click the Trash icon and choose Empty Trash to permanently delete the files.
How to Uninstall Eclipse via Homebrew
If you used Homebrew to install Eclipse, the process is simpler but still leaves user files. First, uninstall the cask:
brew uninstall --cask eclipse-java
This removes the application bundle. Then, follow steps 3 through 6 from the manual process above to clear your workspace and configuration files. Homebrew does not remove those because they are considered user data.
If you are not sure whether you installed via Homebrew, check if the Eclipse folder is inside /Applications or if you see a symlink in /usr/local/bin. Homebrew installs create a symlink to the eclipse executable, so you can run which eclipse in Terminal. If it returns a path like /usr/local/bin/eclipse, it was likely installed via Homebrew.
Common Problems and How to Fix Them
Users often encounter a few issues during uninstall:
- “Eclipse is still running” error – Even after quitting, a background process may linger. Open Activity Monitor, search for “eclipse”, and force-quit any remaining processes before deleting the folder.
- Permission denied when deleting files – Some Eclipse files are locked. Right-click the file, choose Get Info, and check the Sharing & Permissions section. You may need to change the permission to “Read & Write” for your user, or use
sudo rm -rfin Terminal (enter your password when prompted). - Workspace not found after reinstall – If you delete the workspace but later reinstall Eclipse, it will create a new workspace. If you kept the old one, you can point Eclipse to it via File > Switch Workspace.
- Leftover dock icon – If the Eclipse icon stays in the Dock, right-click it, choose Options > Remove from Dock. This is just a shortcut, not a real installation.
What About the Eclipse Installer App?
If you downloaded Eclipse using the installer (the .dmg file that shows a window with an install button), that installer itself is a separate app. It is usually in your Downloads folder or /Applications. Delete it as well if you no longer need it. The installer creates a hidden folder in ~/Library/Application Support/Eclipse Installer – remove that too if you want a complete cleanup.
Note that the Eclipse Installer is not the same as the Eclipse IDE. The IDE is the actual development environment; the installer is just a tool to download and set it up. If you used the installer, you likely have both on your system.
Manual vs. Uninstaller Tools: Which to Choose?
There are third-party uninstaller apps like AppCleaner or CleanMyMac that can scan for leftover files. They work by dragging the Eclipse folder onto the app, and they find related files automatically. These tools are convenient, but they sometimes miss files in less common locations like ~/.eclipse or LaunchAgents. The manual method described above is thorough and free, though it requires a few Terminal commands. If you are uncomfortable with the command line, an uninstaller tool is a safer alternative, but you should still check the hidden folders afterward.
For most users, the manual steps are sufficient and take less than five minutes. The only tricky part is remembering the ~/.eclipse folder, which is hidden by default in Finder. To see hidden files in Finder, press Cmd+Shift+. (period) while in a folder.
Frequently Asked Questions
Do I need to uninstall Java too?
No. Eclipse requires a Java runtime, but Java is a separate installation. If you uninstall Eclipse, Java remains on your system and may be used by other applications. If you want to remove Java as well, use the Java uninstaller provided by Oracle or your package manager, but only if you no longer need Java for anything else.
Will uninstalling Eclipse delete my code?
Only if you delete the workspace folder. The Eclipse application folder contains no user projects by default. Your code is in the workspace you chose when you first launched Eclipse. As long as you keep that folder, your code is safe. If you delete it, your projects are gone permanently unless you backed them up.
Can I just move Eclipse to the Trash and be done?
Yes, for a basic uninstall. Dragging the Eclipse folder to the Trash removes the program and it will no longer run. However, leftover configuration files can cause issues if you reinstall a different version later, and they take up space. For a clean removal, follow the full steps above.
What if I installed Eclipse via a package manager like SDKMAN or MacPorts?
If you used SDKMAN, run sdk uninstall java <version> (if you installed Eclipse through SDKMAN, it is actually Java, not the IDE). For MacPorts, use sudo port uninstall eclipse. In both cases, the user-level folders still need to be removed manually as described.
Is it safe to delete the ~/.eclipse folder?
Yes, if you are uninstalling Eclipse and do not plan to use the same configuration again. That folder contains only Eclipse preferences and plugin data. Deleting it will not affect other software. If you reinstall Eclipse later, it will create a fresh configuration.
Related
Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.
More cards in this drawer
- Samsung Smart Speaker Rollable Display: Facts
- HP 9730e: Wide Prints, Not A3 Scans
- What 8888 Does When You Use It as DNS Server
- Credential Manager: Seamless Sign-In Explained
- API Governance for Public Data: What Growing Portfolios Need
- Enterprise AI Hidden Cost: Data Architecture ROI