285

I'm having some trouble to understand how Node.js acts based on the parameter max-old-space-size.

In my case, for example, I'm running two t2.small AWS instances (2GB of RAM).

Not sure why, but I did set max-old-space-size=4096 (4GB). What does node do in this case? Could this configuration lead to a possible memory allocation failure?

How do I determine the correct value of max-old-space-size based on the server resources?

My application is constantly growing the memory usage and I'm trying to understand everything about node internals.

6
  • 16
    I'm adding a comment now that I see I that this is getting view quiete a lot. It took me a full week to realise that my NodeJS app had no memory leak but that the garbage collector never kicked in. Be aware of this on systems with low memory like t2.micro or t2.small instances. Server is going to crash because of non-available RAM.
    – Borjante
    Jun 8, 2018 at 15:03
  • Was there a way to get the garbage collector to kick in? Sep 6, 2019 at 7:09
  • 5
    The configured max-old-space-size had a higher limit than the total amount of RAM that the machine had.
    – Borjante
    Dec 27, 2019 at 7:38
  • 3
    Worth trying --optimize-for-size to reduce memory usage. Nov 27, 2020 at 14:19
  • 1
    @ZG101 To get the garbage collector to run, see stackoverflow.com/questions/27321997/… Mar 2, 2021 at 10:50

4 Answers 4

333

"Old space" is the biggest and most configurable section of V8's managed (aka garbage-collected) heap (i.e. where the JavaScript objects live), and the --max-old-space-size flag controls its maximum size. As memory consumption approaches the limit, V8 will spend more time on garbage collection in an effort to free unused memory.

If heap memory consumption (i.e. live objects that the GC cannot free) exceeds the limit, V8 will crash your process (for lack of alternative), so you don't want to set it too low. Of course, if you set it too high, then the additional heap usage that V8 will allow might cause your overall system to run out of memory (and either swap or kill random processes, for lack of alternative).

In summary, on a machine with 2GB of memory I would probably set --max-old-space-size to about 1.5GB to leave some memory for other uses and avoid swapping.

4
  • 20
    That's exactly what I was hoping to get for an answer, describing the edge case where either the system or Node runs out of memory.
    – Borjante
    Jan 23, 2018 at 9:39
  • 2
    @jmrk: Seems you are totally right, but when I am using 2GB RAM and 4GB swap and set "--max-old-space-size" to 4GB then node process consume all RAM memory and stuck on 1.9GB. The question is here "Why swap is avoid to use ?? " (Node version 8.11.1) May 17, 2018 at 8:43
  • 1
    The flag should override anything else. Please double-check for typos.
    – jmrk
    May 18, 2018 at 19:58
  • 2
    From d8 --help: --max-old-space-size (max size of the old space (in Mbytes))
    – jmrk
    Mar 27, 2019 at 21:21
173

2020 Update

These options are now documented officially by node. For a 2GB machine, you should probably use:

NODE_OPTIONS=--max-old-space-size=1536

What are 'new space' and 'old space' anyway?

There's an excellent answer on "what are new space and old space?".

To determine the amount to use

You can see available memory on a Linux machine using free -m. Note that you can consider the total of the free and the buffers/cache memory as available, as buffers/cache can be thrown away instantly when needed (these buffers and cache are a nice way to use otherwise unused memory).

The official documentation formax-old-space-size also mentions:

On a machine with 2GB of memory, consider setting this to 1536 (1.5GB)

Hence the value above. Consider that the amount of memory needed for the base OS doesn't change much, so you could happily do 3.5 on a 4GB machine etc.

To notice the defaults and see the effect of changes:

The default is 2GB:

$ node

> v8.getHeapStatistics()
{
  ....
  heap_size_limit: 2197815296,
}

2197815296 is 2GB in bytes.

When set to 8GB, you can see heap_size_limit changes:

$ NODE_OPTIONS=--max_old_space_size=8192 node
Welcome to Node.js v14.17.4.
Type ".help" for more information.
> v8.getHeapStatistics()
{
  ...
  heap_size_limit: 8640266240,
  ...
}

As @Venryx mentions below you can also use process.memoryUsage()

11
  • 3
    From the link you've shared from Node.js docs, it says: "On a machine with 2GB of memory, consider setting this to 1536 (1.5GB)"
    – Idan Dagan
    Oct 14, 2020 at 12:29
  • 1
    Thanks @IdanDagan I'll add that to the answer. Oct 14, 2020 at 12:39
  • 2
    Nitpick: there is no reason to prefer a "round number" here. 1535 or 1537 or 1500 or 1555 are just as good.
    – jmrk
    Mar 2, 2021 at 10:00
  • 2
    As an alternative to v8.getHeapStatistics(), you can also use: process.memoryUsage() (as seen here)
    – Venryx
    Jan 11, 2022 at 5:27
  • 1
    @mikemaccana You state the default is 2GB but I think the default is dynamic based on total system memory or something. For instance on a VM with ~21GB total ram, my heap_size_limit is 4345298944 or ~4GB Nov 17, 2022 at 18:13
96

This error occurs when the memory allocated for the executing application is less than the required memory. By default, the memory limit in Node.js is 512 MB. To increase this amount, you need to set the memory limit argument —-max-old-space-size. It will help avoid a memory limit issue.

node --max-old-space-size=1024 index.js #increase to 1gb
node --max-old-space-size=2048 index.js #increase to 2gb
node --max-old-space-size=3072 index.js #increase to 3gb
node --max-old-space-size=4096 index.js #increase to 4gb
node --max-old-space-size=5120 index.js #increase to 5gb
node --max-old-space-size=6144 index.js #increase to 6gb
node --max-old-space-size=7168 index.js #increase to 7gb
node --max-old-space-size=8192 index.js #increase to 8gb

https://medium.com/@vuongtran/how-to-solve-process-out-of-memory-in-node-js-5f0de8f8464c

12
  • and it should be more than allocated Ram memory
    – HD..
    Jul 24, 2020 at 11:13
  • 3
    It's difficult to find corroboration on that; I can't find anything explicit in the docs for V8 or Node. Another system I have reports the default for v10, 12 & 14. as 0. FWIW I have found a couple of more recent bloggers stating max memory as 1.5Gb (tejom.github.io/general/nodejs/v8/debugging/2017/01/16/…) and that v12 has a dynamic max based on the system (idginsiderpro.com/article/3257673/…).
    – jaybeeuu
    Jul 29, 2020 at 15:29
  • 19
    node -e "console.log(`node heap limit = ${require('v8').getHeapStatistics().heap_size_limit / (1024 * 1024)} Mb`)" -> v12.18.0 and v14.3.0 -> 2096Mb, v10.20.1 -> 1432Mb
    – jaybeeuu
    Jul 29, 2020 at 15:48
  • 23
    @JaySeeAre, thanks for that command to show the heap_size_limit. For a normal UNIX shell, it needs to be quoted differently: node -e 'console.log(`node heap limit = ${require("v8").getHeapStatistics().heap_size_limit / (1024 * 1024)} Mb`)' Oct 1, 2020 at 14:33
  • 2
    I do not have index.js file in my project, somebody please help me out. May 29, 2021 at 9:28
0

For me, Azure function invocations was terminating in a 7GB instance when the memory consumption is near to 2GB with the following error message.

Exception while executing function: Functions.graphql-mobile node exited with code 134
 [24164:000001CE2EB5CF00] 10557962 ms: Scavenge (reduce) 2041.0 (2050.5) -> 2040.1 (2051.5) MB, 2.3 / 0.1 ms  (average mu = 0.179, current mu = 0.002) allocation failure ,FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory, 3: 00007FF73E006026 node::OnFatalError+294 

I solved the issue by setting max-old-space-size like this in my application settings

"languageWorkers:node:arguments": "--max-old-space-size=5500"

Your Answer

Reminder: Answers generated by Artificial Intelligence tools are not allowed on Stack Overflow. Learn more

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.