Error: ENOSPC: System limit for number of file watchers reached
Linux ran out of inotify watches — dev servers watching large projects hit the limit.
Exact message you may see
System limit for number of file watchers reachedENOSPC: System limit
Seen on:
npm
Meaning
Not disk space: it’s fs.inotify.max_user_watches (often 8192). Webpack/Vite/Jest watching node_modules exhausts it.
Common causes
- Low inotify limit
- Watching node_modules or large folders
- Many projects/IDEs watching at once
⚡ Quick fix
- Raise the limit: fs.inotify.max_user_watches=524288
- Exclude node_modules from watchers
Detailed fix by platform
Linux
echo fs.inotify.max_user_watches=524288 | sudo tee /etc/sysctl.d/99-inotify.conf && sudo sysctl --system
How to diagnose
- Limit — cat /proc/sys/fs/inotify/max_user_watches
- Recent change — Did it start after a deploy, upgrade, or configuration change? Compare with the last working version.
🔧 Still not fixed?
Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:
Similar errors
Most viewed in npm
Other ways to find it
Where this error sits
Origin: Build & delivery. Errors that are often confused with or caused by this one (click to open):
🧠 Still stuck? Analyze your error
Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.
💬 What worked for others
No tips yet — did something else fix this for you?
Share what worked for you
Tips are checked by an editor before they appear. Links are removed.
Did this fix work for you?
Report a correction or suggest an improvement
Last updated 12 Oct 2026