What are the Xms and Xmx parameters in JVMs - and what are their default values?
5 Answers
The flag Xmx specifies the maximum memory allocation pool for a Java Virtual Machine (JVM), while Xms specifies the initial memory allocation pool.
This means that your JVM will be started with Xms amount of memory and will be able to use a maximum of Xmx amount of memory. For example, starting a JVM like below will start it with 256 MB of memory and will allow the process to use up to 2048 MB of memory:
java -Xms256m -Xmx2048m
The memory flag can also be specified in different sizes, such as kilobytes, megabytes, and so on.
-Xmx1024k
-Xmx512m
-Xmx8g
The Xms flag has no default value, and Xmx typically has a default value of 256 MB. A common use for these flags is when you encounter a java.lang.OutOfMemoryError.
When using these settings, keep in mind that these settings are for the JVM's heap, and that the JVM can and will use more memory than just the size allocated to the heap. From Oracle's documentation:
Note that the JVM uses more memory than just the heap. For example Java methods, thread stacks and native handles are allocated in memory separate from the heap, as well as JVM internal data structures.
-
26So is it like when memory usage exceeds beyond Xmx we get jvm out of memory exception.– PankajCommented Feb 7, 2013 at 23:41
-
77Yes, that's correct. When it tries to exceed that, although it may collect garbage to try to free up enough memory. If there still isn't enough memory to satisfy the request and the heap has already reached the maximum size, an
OutOfMemoryErrorwill occur. Commented Oct 10, 2013 at 17:38 -
2When I'm using the ForkJoin framework my computer crashes because it's taking up too much memory. Is it possible that on OpenJDK there is no hard limit on the memory by default? Commented May 26, 2014 at 13:33
-
11As clarified at Does java -Xmx 1G mean 1 GB or 2^30 B?, the unambiguous way to express how much memory you start with via
-Xms256mis "256 MiB", not "256 MB", since it goes by binary powers rather than powers of ten. See en.wikipedia.org/wiki/Binary_prefix. In addition, because some unusable space is set aside for an extra pool of Survivor space, the amount of memory actually available according toRuntime.getRuntime().maxMemory()is less than the value specified via -Xmx– nealmcbCommented Sep 30, 2015 at 5:20 -
2A useful guide of common errors relating to heap size: blog.paulgu.com/java/6-common-errors-in-setting-java-heap-size Commented Dec 15, 2015 at 15:32
Run the command java -X and you will get a list of all -X options:
C:\Users\Admin>java -X
-Xmixed mixed mode execution (default)
-Xint interpreted mode execution only
-Xbootclasspath:<directories and zip/jar files separated by ;>
set search path for bootstrap classes and resources
-Xbootclasspath/a:<directories and zip/jar files separated by ;>
append to end of bootstrap class path
-Xbootclasspath/p:<directories and zip/jar files separated by ;>
prepend in front of bootstrap class path
-Xdiag show additional diagnostic messages
-Xnoclassgc disable class garbage collection
-Xincgc enable incremental garbage collection
-Xloggc:<file> log GC status to a file with time stamps
-Xbatch disable background compilation
-Xms<size> set initial Java heap size.........................
-Xmx<size> set maximum Java heap size.........................
-Xss<size> set java thread stack size
-Xprof output cpu profiling data
-Xfuture enable strictest checks, anticipating future default
-Xrs reduce use of OS signals by Java/VM (see documentation)
-Xcheck:jni perform additional checks for JNI functions
-Xshare:off do not attempt to use shared class data
-Xshare:auto use shared class data if possible (default)
-Xshare:on require using shared class data, otherwise fail.
-XshowSettings show all settings and continue
-XshowSettings:all show all settings and continue
-XshowSettings:vm show all vm related settings and continue
-XshowSettings:properties show all property settings and continue
-XshowSettings:locale show all locale related settings and continue
The -X options are non-standard and subject to change without notice.
I hope this will help you understand Xms, Xmx as well as many other things that matters the most. :)
-Xms is the initial heap size for the startup, however, during the working process, the heap size can be less than -Xms due to users' inactivity or GC iterations. This is not a minimum required heap size.
-Xmx is the maximum heap size
-
3Could you please give more details about "due to users' inactivity or GC iterations"? And what is the difference between initial and minimal heap sizes then?– TonyCommented Jan 24, 2021 at 7:18
-
I just realized today that
-Xmsdoesn't indicate minimum required heap memory size. We are running a java process with-Xmsset to 200 GB running on a machine with 256 GB RAM. And the process is only consuming 10 GB so far and that's because not much activity was done by the process so far. So, this answer did confirm that but I'm looking to see the documentation/sources about this. thank you so much!– asgsCommented Jun 3, 2022 at 16:46 -
2There are three heap sizes: used, committed, and max. Used heap size can be less than -Xms, but committed heap size (i.e. allocated from the OS via malloc()) is always at least -Xms. Some operating systems will happily malloc() more memory than the have and hope not all applications actually use everything they malloc()ed, so "committed" is a somewhat relative term. Commented Jun 28, 2022 at 12:15
You can specify it in your IDE. For example, for Eclipse in Run Configurations → VM arguments. You can enter -Xmx800m -Xms500m as

-
In RubyMine on OSX, it's in Help menu > Edit Custom VM Options. Commented Sep 19, 2018 at 20:33
-
31This doesn't answer the question. The question is about what they are for, not how to set them. Commented Feb 6, 2019 at 17:18
The question itself has already been addressed above. Just adding part of the default values.
As per http://docs.oracle.com/cd/E13150_01/jrockit_jvm/jrockit/jrdocs/refman/optionX.html
The default value of Xmx will depend on platform and amount of memory available in the system.
-
8For other JVMs (besides JRockit), see this post to determine default Xmx/Xms values of your JVM: stackoverflow.com/questions/4667483/… Commented Aug 21, 2014 at 14:13
-Xmx128m -Xms64mit can peak around275mRES mem, but when using-Xmx128m -Xms128mit can peak around550mRES mem Using Java 8 Best thing is to stress the GC and look at what happens ...