// Tutorial //

eclipse.ini vm arguments - eclipse.ini File Location Mac, Windows

Published on August 3, 2022
Default avatar
By Pankaj
Developer and author at DigitalOcean.
eclipse.ini vm arguments - eclipse.ini File Location Mac, Windows

While we believe that this content benefits our community, we have not yet thoroughly reviewed it. If you have any suggestions for improvements, please let us know by clicking the “report an issue“ button at the bottom of the tutorial.

eclipse.ini is the configuration file used to control the Eclipse startup. We can configure Eclipse VM arguments such as JDK to be used (eclipse.ini vm), permgen space, maximum and minimum heap size using Xms, Xmx parameters.

eclipe.ini File Location

For windows, it’s in the same directory as eclipse.exe file, as shown in below image. eclipse.ini file location, eclipse.ini vm, eclipse.ini windows For Mac OS X, it’s found inside the app. So if Eclipse app is in Downloads directory, eclipse.ini file location will be:

pankaj$ cd ~/Downloads/Eclipse.app/Contents/Eclipse/

You can reach this location by first right clicking on Eclipse app and click on “Show Package Contents” and then in the next window navigate to Contents/Eclipse directory, as shown in below images. eclipse.ini, eclipse.ini vm eclipse.ini file, eclipse.ini file location mac Here is the example eclipse.ini file from my default eclipse installation.


Some important points about eclipse.ini file are:

  1. Each line before -vmargs contains an option followed by the value for option.
  2. All the lines after -vmargs are passed as JVM arguments, so all options and arguments for eclipse startup must be specified before -vmargs. For example -vm settings for JDK to be used.
  3. --launcher.XXMaxPermSize specifies the maximum permgen space to use by eclipse launcher, increase this value if your eclipse startup is failing with out of memory error.
  4. If you are getting Out of Memory errors, you should try to increase Permgen space and maximum heap space values. They are configured using VM arguments -XX:MaxPermSize, -Xms and -Xmx. Permgen space default value is configured as 256MB that is good for small to medium projects.

eclipse.ini vm argument

eclipse.ini vm argument is useful when you have multiple JDK installation and you want to make sure that your eclipse runs on a specific JVM, rather than picking system configured jdk path. It must be defined before -vmargs.

eclipse.ini vm argument Mac

My eclipse.ini file snippet showing -vm argument usage to configure eclipse to use JDK8 in Mac OS X.


You can configure it similarly for Windows or Linux operating systems. Just change the JDK bin directory path accordingly.

eclipse.ini Permgen Space

If you are getting java.lang.OutOfMemoryError: PermGen space error, mostly when you are working on larger code base, doing maven update for large projects etc. , then you should increase Permgen space. Below is the configuration to increase permgen space to 512 MB in eclipse.ini file.


Note that there is no more Permgen space from Java 8 onwards, so setting this option will have no effect. However you will also not get out of memory error because of permgen space.

eclipse.ini Heap Space

If you are getting OutOfMemoryError related to Heap space, then you can try to increase the maximum heap size available to eclipse. You can easily do it by editing -Xmx value. For example, below snippet will increase the eclipse heap size to 2 GB.


That’s all for a quick roundup on eclipse.ini configuration and VM arguments.

Want to learn more? Join the DigitalOcean Community!

Join our DigitalOcean community of over a million developers for free! Get help and share knowledge in our Questions & Answers section, find tutorials and tools that will help you grow as a developer and scale your project or business, and subscribe to topics of interest.

Sign up
About the authors
Default avatar


Developer and author at DigitalOcean.

Still looking for an answer?

Was this helpful?

i have tizen studio and increased XMS to 512 M and try to build project but it shows jvm terminated error exit 1. when i decrease xms it shows heap space/

- Mansur Rizoev

    The snippet in the “eclipse.ini vm argument Mac” section helped me fix a problem encountered yesterday. After installing new JDKs for Java14 and new JDK8, STS 4 wouldn’t start (saw error message “Unable to create Java Virtual Machine”). Yesterday I was able to prove the sts.ini needed to be updated to change to a different JDK, and the snippet in this tip helped me make that change and get STS 4 running again, so I am once again a productive developer. Thank you - many tips about this issue were aimed at people using Windows computers instead of Macs.

    - Mike Hubbartt

      Hi how to set VM argument via Java programs

      - Praveenraj

        Hi, Can I set a system variable in eclipse.ini and read using runtime?

        - Radhakrishna