Detailed information for the notes.ini Keyword: 


Short Description: Manage HTTP JVM rather than increasing the JVM default of 64MB


Was added to support the new XPages functionality of the Domino Web server. HTTPJVMJavaMaxHeapSize was introduced to manage HTTP JVM rather than increasing the JVM default of 64MB as it would impact all processes, not just HTTP.

Beginning in Domino 8.5, a new notes.ini file parameter, HTTPJVMMaxHeapSize=256M, was added to control memory allocation to allow the new XPages functionality to work correctly. In prior releases, the default memory allocation was 64MB. Customers running close to the 32-bit limit of 2GB of memory allocated for the Domino HTTP process could experience memory constraints with this value at the default 256MB setting. You can check process usage at the Operating System level to determine if you are close to reaching the 2GB limit.

If you are not using XPages and have not previously reconfigured your JVM maximum heap size for other application requirements, we recommend that you reset the notes.ini parameter of your Domino server to consume less memory. To do this, edit your notes.ini file and change 256M to 64M like this:


Important Notes:

  • You will need to have Domino 8.5.1 or greater to be able to change the value of this parameter. The inability to edit this parameter in Domino 8.5 was reported in SPR# HSAO7PSNUQ and is fixed in 8.5.1.
  • You will need to restart Domino HTTP in order to see this change become active.
  • 64MB will be the new default value for 8.5.2 and later.
  • This parameter was created to control memory allocation for XPages, but has been found to impact other features/products, such as Quickr for Domino.
  • This information is specific to Domino 8.5 and 8.5.1 for all Domino 32-bit platforms (Windows 32, AIX 32, Solaris and Linux). It does not apply to any Domino 64-bit platforms.


The ultimate solution IBM offers for systems trying to manage the 2GB memory space is 64-bit Domino. With a 64-bit platform, far greater amounts of memory are available to the Domino processes allowing sufficient system resources for your applications. XPages is an exciting new way to work with Domino applications. It brings Domino fully into Web 2.0 technologies as a world class leader.

Default value:


UI equivalent:
There is no kown UI setting for this notes.ini variable. But you can specify this setting in the notes.ini settings tab of the configuration settings document.

Applies to:

Entry created by:
Bastian W.