What This Error Means
npm ran out of disk space while writing files (ENOSPC).
How to Fix It
- Identify the path npm is failing on (look for the last referenced file path in the error output).
- Free disk space and retry. Also check Docker/CI runner disk quotas if this happens in CI.
- Retry after cleaning local state when safe (common: remove
node_modulesand retry install).
Why It Happens
- The filesystem ran out of space while npm was extracting/writing files.
How to Verify
- Re-run the original command and confirm the filesystem error no longer appears.
- If this is a permission fix, confirm new files in
node_modulesare owned by the expected user.
Manual filesystem checks
- Check disk space:
df -h.
Common CLI Output
npm ERR! code ENOSPC Prevention Tips
- Keep npm cache and project directories owned by the build user.
- Avoid running project installs as root unless you know exactly why you need it.
- Ensure CI runners have enough disk space and sensible file descriptor limits.
Where This Can Be Triggered
github.com/npm/cli/blob/417daa72b09c5129e7390cd12743ef31bf3ddb83/lib/commands/cache.js
This is a representative filesystem write path during npm operations. Filesystem codes like this are raised by Node/OS when this write fails. - GitHub
break
}
output.standard(`Deleted: ${key}`)
await cacache.rm.entry(cachePath, key)
// XXX this could leave other entries without content!
await cacache.rm.content(cachePath, entry.integrity)
}