JIRA Documentation

JIRA 6.0 Documentation
JIRA 5.2 Documentation
JIRA 5.1 Documentation


Search the Knowledge Base and Documentation Spaces

You're visiting the JIRA Knowledge Base. Visit the JIRA Knowledge Base Home for an overview.

Skip to end of metadata
Go to start of metadata

This page describes a singular cause for Out Of Memory Heap Space Errors. Refer to JIRA Crashes Due to OutOfMemoryError Java heap space for a general discussion.


JIRA crashes after running out of memory. Logs contain the error message OutOfMemory Errors.


Tomcat 5 caches JSP content. If JIRA is generating huge responses (eg. multi-megabyte Excel or RSS views), then these cached responses will quickly fill up memory and result in OutOfMemoryErrors.

Do not deploy multiple Atlassian applications in a single Tomcat container

Deploying multiple Atlassian applications in a single Tomcat container is not supported. We do not test this configuration and upgrading any of the applications (even for point releases) is likely to break it. There are also a number of known issues with this configuration (see this FAQ for more information).

We also strongly recommend not deploying multiple Atlassian applications to a single Tomcat container for a number of practical reasons. Firstly, you must shut down Tomcat to upgrade any application and secondly, if one application crashes, the other applications running in that Tomcat container will be inaccessible.

Finally, we recommend not deploying any other applications to the same Tomcat container that runs JIRA, especially if these other applications have large memory requirements or require additional libraries in Tomcat's lib subdirectory.


  1. In Tomcat 5.5.15+, set the org.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER=true property (see Setting Properties and Options on Startup). This is automatically set in JIRA's stand-alone distributions.
  2. As a temporary measure, increase JIRA's Heap Space allocation.
  3. For a more permanent resolution, upgrade Tomcat.


Related Content

Help us improve!
Is this article helpful?
Is the content complete?
Is it well written?