How do I configure the memory for Portal?

The Kadeck (DSH) 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 XTK_KADECK_OPTS environment variable.

Example Docker run configuration:

-e XTK_KADECK_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

info

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