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.

Recommended Memory Settings

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.