Error2 Fixes Available

Fix: Bun install FATAL ERROR: Reached heap limit

FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory

What does this error mean?

Despite being 10x faster than npm, Bun's package manager can sometimes hit memory limits when resolving extremely large or deeply nested monorepo dependencies. This is usually due to the rapid-fire concurrent network requests overwhelming the heap.

Common Causes

Extremely large node_modules tree in a legacy project
Running Bun in a restricted CI environment (e.g., 512MB RAM)
Corruption in the bun.lockb binary lockfile

How to Fix It (2 Solutions)

Increase Heap Limit

You can pass v8 flags directly to Bun to increase the memory allowance.

Code

BUN_ARGV="--max-old-space-size=4096" bun install

Clean Bun Cache

Try clearing the local cache to remove potentially corrupted package artifacts.

Code

bun pm cache rm

Related Errors

npm ERR! ERESOLVE unable to resolve dependency tree

View fix

npm ERR! EACCES permission denied

View fix

Browse all error fixes