210

If something is not working properly or some plug-ins are not loaded properly in my Eclipse I often get suggestion to open Eclipse in clean mode.

So, how to run in clean mode? And what happens if I do so?

10 Answers 10

283

What it does:

if set to "true", any cached data used by the OSGi framework and eclipse runtime will be wiped clean. This will clean the caches used to store bundle dependency resolution and eclipse extension registry data. Using this option will force eclipse to reinitialize these caches.

How to use it:

  • Edit the eclipse.ini file located in your Eclipse install directory and insert -clean as the first line.
  • Or edit the shortcut you use to start Eclipse and add -clean as the first argument.
  • Or create a batch or shell script that calls the Eclipse executable with the -clean argument. The advantage to this step is you can keep the script around and use it each time you want to clean out the workspace. You can name it something like eclipse-clean.bat (or eclipse-clean.sh).

(From: http://www.eclipsezone.com/eclipse/forums/t61566.html)

Other eclipse command line options: http://help.eclipse.org/indigo/index.jsp?topic=%2Forg.eclipse.platform.doc.isv%2Freference%2Fmisc%2Fruntime-options.html

8
  • 37
    I recommend (2), creating a 'second' eclipse shortcut with the clean option. You don't want it in the eclipse.ini file, because that would disable the useful OSGi caching and increase eclipse startup time. Use clean only when you feel that you have to. Jan 8, 2010 at 22:00
  • 4
    @Andreas_D, so basically you should recommend (3) Oct 4, 2012 at 13:21
  • 4
    @SpaceRocker - why should I? Recommend whatever you like. I keep recommending the variation of "2", a second shortcut for "eclipse clean" (for windows environments, of course) Oct 4, 2012 at 23:02
  • 1
    In ubuntu in my ini file the first line is '-startup' I suppose I need to delete that in case i want to run it in clean mode? (and replace with -clean)? Jan 8, 2014 at 13:51
  • 2
    I edited your post because I down voted it by mistake and this was the only possibility to up vote your post (to remove an empty line). Sorry for this insignificant change, but the votes were locked. Oct 30, 2015 at 13:46
82

For clean mode: start the platform like

eclipse -clean

That's all. The platform will clear some cached OSGi bundle information, it helps or is recommended if you install new plugins manually or remove unused plugins.

It will not affect any workspace related data.

1
  • 4
    liked the info that it wont alter the workspace data!
    – mons droid
    Apr 15, 2015 at 9:06
36

You can start Eclipse in clean mode from the command line:

eclipse -clean
18

Using the -clean option is the way to go, as mentioned by the other answers.

Make sure that you remove it from your .ini or shortcut after you've fixed the problem. It causes Eclipse to reevaluate all of the plugins everytime it starts and can dramatically increase startup time, depending on how many Eclipse plugins you have installed.

13
  • click on short cut
  • right click -> properties
  • add -clean in target clause and then start.

it will take much time then normal start and it will fresh up all resources.

10

For Mac OS X Yosemite I was able to use the open command.

Usage: open [-e] [-t] [-f] [-W] [-R] [-n] [-g] [-h] [-b <bundle identifier>] [-a <application>] [filenames] [--args arguments]
Help: Open opens files from a shell.
      By default, opens each file using the default application for that file.  
      If the file is in the form of a URL, the file will be opened as a URL.
Options: 
      -a                Opens with the specified application.
      -b                Opens with the specified application bundle identifier.
      -e                Opens with TextEdit.
      -t                Opens with default text editor.
      -f                Reads input from standard input and opens with TextEdit.
      -F  --fresh       Launches the app fresh, that is, without restoring windows. Saved persistent state is lost, excluding Untitled documents.
      -R, --reveal      Selects in the Finder instead of opening.
      -W, --wait-apps   Blocks until the used applications are closed (even if they were already running).
          --args        All remaining arguments are passed in argv to the application's main() function instead of opened.
      -n, --new         Open a new instance of the application even if one is already running.
      -j, --hide        Launches the app hidden.
      -g, --background  Does not bring the application to the foreground.
      -h, --header      Searches header file locations for headers matching the given filenames, and opens them.

This worked for me:

open eclipse.app --args clean
6

Easier option is to use ./eclipse -clean

3

Two ways to run eclipse in clean mode.

1 ) In Eclipse.ini file

  • Open the eclipse.ini file located in the Eclipse installation directory.
  • Add -clean first line in the file.
  • Save the file.
  • Restart Eclipse.

enter image description here

2 ) From Command prompt (cmd/command)

  • Go to folder where Eclipse installed.
  • Take the path of Eclipse
  • C:..\eclipse\eclipse.exe -clean
  • press enter button

enter image description here

2

For Windows users: You can do as RTA said or through command line do this: Navigate to the locaiton of the eclipse executable then run:

 eclipse.lnk -clean

First check the name of your executable using the command 'dir' on its path

0

This will clean the caches used to store bundle dependency resolution and eclipse extension registry data. Using this option will force eclipse to reinitialize these caches.

  1. Open command prompt (cmd)
  2. Go to eclipse application location (D:\eclipse)
  3. Run command eclipse -clean

Not the answer you're looking for? Browse other questions tagged or ask your own question.