Knowledgebase: Pre-Sales
How to Configure Memory Allocated to FileCatalyst Workflow and Webmail
Posted by Aly Essa, Last modified by Jeyram Sachchithananthan on 04 May 2021 11:03 AM


All of our FileCatalyst Products are installed with default memory limits, including both initial reserve and maximum memory. However, these can be configured to fit your specific needs and environment. This article will go through the configuration process for FileCatalyst Workflow or Webmail for Windows, Linux.


  • For all environments:
    If you are using a 32-bit Operating System or Java 32-bit, the maximum memory you can define for JAVA is limited to 1.5GB of memory.  64-bit Operating Systems running 64-bit Java do not have such memory limitations.
  • It is also recommended (but not required) to set the minimum and the maximum memory to the same value, as this allows JAVA to allocate a single continuous block of the memory from the OS on startup.
  • Have all Tomcat Server Service shut down before editing any configuration files.


FileCatalyst Workflow v4.9 and later.

FileCatalyst Webmail v4.9 and later.




When FileCatalyst Webmail or Workflow is installed on a Windows machine, there are two ways to increase the memory used.

  1. The first is to use the tomcat7w.exe or tomcat8w.exe, which is located in the \apache-tomcat\bin folder. A sample path would be C:\Program Files\Apache Software Foundation\Tomcat 9.0\bin\.
    1. Run tomcat9w.exe or tomcat9w.exe as an administrator. You can right-click the file and select the Run as Administrator.
    2. When the Tomcat Properties opens, select the Java tab.
    3. Increase Initial and Maximum Memory Pools as required. We recommend using identical values so the memory block is contiguous.

  2. The second method is to edit your catalina.bat file.
    1. Open the catalina.bat file in a text editor, which is located in the \apache-tomcat\bin. A sample path would be C:\Program Files\Apache Software Foundation\Tomcat 7.0\bin\
    2. Add the following line:

      set JAVA_OPTS="-Xms1024m -Xmx1024m -XX:NewSize=256m -XX:MaxNewSize=356m -XX:PermSize=256m -XX:MaxPermSize=356m"

      Again we recommend using identical values for both Xms and Xmx so your memory block is contiguous.


For a deployment of FileCatalyst Webmail or Workflow is installed on a Linux machine, the startup script needs to be editted.

  1. Navigate to the /apache-tomcat/bin/ folder and open the file in a text editor such as vi.
  2. Add the following line at the bottom of the file:

    export JAVA_OPTS="-Xms1024m -Xmx1024m -XX:NewSize=256m -XX:MaxNewSize=356m -XX:PermSize=256m -XX:MaxPermSize=356m"

    We recommended that the Xms and Xmx values be identical so your memory block is contiguous.