Skip to content
You are reading the Teku development version documentation and some features may not be available in the stable release. You can switch to the stable version using the version box at the bottom of the screen.

Updated on September 29, 2020

Managing memory

Manage Teku’s Java Virtual Machine (JVM) memory usage by setting a maximum heap size using the JAVA_OPTS environment variable.

We recommend setting the maximum heap size to 2GB if you have less than 8GB of RAM, or if you have more RAM, but want to free up memory for other processes. This results in an approximate process size of 3.5GB (on Linux).

Set the heap size using the environment variable, or using the command line when starting Teku.

export JAVA_OPTS=-Xmx2g
JAVA_OPTS=-Xmx2g ./teku [options]


The node uses more RAM to perform better if it’s available, especially during periods of non-finalization.

Questions or feedback? You can discuss issues and obtain free support on Teku Discord channel.
For paid professional support by Consensys, contact us at