Install from ZIP File

Increase Eclipse's Heap Size

Eclipse stores all of your Java code in memory, and we recommend at least 1024MB of memory on most projects. To set Eclipse's heap size:

1. Open the eclipse.ini file found in your eclipse directory.
2. Add or modify the heap vmargs parameter -Xmx. Setting it to 1024M or greater is recommended.
   
   Example eclipse.ini

   -startup
   plugins\org.eclipse.equinox.launcher_1.0.101.R34x_v20080819.jar
   --launcher.library
   plugins\org.eclipse.equinox.launcher.win32.win32.x86_1.0.101.R34x_v20080731
   -showsplash
   org.eclipse.platform
   --launcher.XXMaxPermSize
   256m
   -vmargs
   -Xms40m
   -Xmx1024M
   

3. After making your changes, you need to restart Eclipse.
4. Alternatively, you can modify the way Eclipse is run from the command line:

   eclipse -vmargs -Xmx1024M

You can monitor Eclipse's heap status from the menu by selecting Window > Preferences > General and checking the Show heap status checkbox. This should add a heap status widget at the lower-right corner of your Eclipse environment. You can hover over the widget to check if the maximum heap size was properly set by your changes.

Known Eclipse Memory Issues:

• When running Eclipse on 32-bit Java, you may not be able to set the Xmx value to greater than ~1200M without Eclipse crashing. As far as we can tell this is a limitation of the VM. So far the only solution we have found is to use 64-bit Java.
• When running on 64-bit Java, you may need to increase the --launcher.XXMaxPermSize settings to 1024M when working on large projects.
• On some machines, you may not be able to set the Xmx value to greater than ~500M. You may be able to solve this issue by adding
  

  -vm <location of java executable>

  For example:
  

   -vm c:\Program Files\Java\jdk1.6.0_06\bin\java

  This may be caused by not having declared the JAVA_HOME environment variable.