Workato · On-prem agent

java.lang.OutOfMemoryError: Java heap space (on-prem agent)

Short answer

This error in the on-prem agent log means the agent does not have enough memory for a large job or payload. Raise the Java heap with the -Xmx option and restart the agent.

VerifiedLast verified

01Error text

Workato error
java.lang.OutOfMemoryError: Java heap space

02Likely causes

  • The on-prem agent lacks memory for large jobs or payloads.
  • The heap size defaults to a fraction of the available system memory.

03How to fix it

  1. On Windows, open the Service Wrapper Configuration app for the agent, go to the Java tab and add -Xmx to the Java Options field, for example -Xmx10G for 10 GB. Click Apply.
  2. On Linux, Mac or Docker, add -Xmx to JAVA_OPTIONS in run.sh, for example JAVA_OPTIONS="${JAVA_OPTIONS:-} -Xmx10G".
  3. Restart the agent.

04Official documentation

Test every fix in a non-production environment before you apply it to production. See how entries are verified.

More for Workato work:Open Workato jobsWorkato rates and salariesHire a senior Workato developer

The iPaaS Brief

Subscribe to The iPaaS Brief.

The iPaaS newsletter for the people who run integrations. From iPaaS Group.

Free. You finish on theipaasbrief.com and confirm by email.