How do I configure the memory for Portal?

The Data Streamhouse Portal runs on a Java runtime inside the container.

To ensure stable and predictable performance, it is important to configure the JVM memory settings explicitly.

Set the initial (-Xms) and maximum (-Xmx) heap sizes using the DSH_PORTAL_OPTS environment variable.

Example Docker run configuration:

-e DSH_PORTAL_OPTS="-Xms8g -Xmx12g"

This configures Portal to:

  • Allocate 8 GB of memory at startup

  • Allow up to 12 GB maximum memory usage

Minimum Recommendation

  • 8 GB RAM minimum for Portal instances

  • Adjust -Xmx based on the expected number of users and concurrent data exploration sessions

Note: Always ensure that the container memory limit matches or exceeds the configured -Xmx value to prevent out-of-memory (OOM) errors.

Last updated

Was this helpful?