diff --git a/doc/build.md b/doc/build.md
index ea7b4933..06035daa 100644
--- a/doc/build.md
+++ b/doc/build.md
@@ -45,12 +45,15 @@ $ script/uberjar
 $ script/compile
 ```
 
-To configure maximum heap size you can use:
+To configure max heap size you can use:
 
 ```
-$ export BABASHKA_XMX="-J-Xmx4800m"
+$ export BABASHKA_XMX="-J-Xmx6500m"
 ```
 
+Note: setting the max heap size to a low value can cause the build to crash or
+take long to complete.
+
 ## Windows
 
 To compile on Windows you need to check out the `windows` branch: