npm ERR! code EEXIST — EEXIST: file already exists, symlink '../lib/node_modules/x/bin/x' -> '/usr/local/bin/x'
A global install can’t create its command link because a file with that name already exists.
Seen on:
npm
Meaning
Another installation (Homebrew, a different Node version, or an older global package) owns the binary name.
Common causes
- Binary installed by Homebrew/another manager
- Leftover link from an old global install
⚡ Quick fix
- npm install -g pkg --force to overwrite
- Remove the old binary/package first
- Use a Node version manager to avoid clashes
Detailed fix by platform
npm
npm uninstall -g yarn && npm install -g yarn
How to diagnose
- Path — Which binary exists and who installed it?
- Recent change — Did it start after a deploy, upgrade, or configuration change? Compare with the last working version.
🧠 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.
Was this page helpful?
Report a correction or suggest an improvement
Last updated 2 Oct 2026