EBADENGINE 🟩 Node.js

npm WARN EBADENGINE Unsupported engine / The engine "node" is incompatible with this module

A package requires a different Node.js version than the one you’re running.

Seen on: Node.js

Meaning

package.json "engines" declares supported versions. npm warns (EBADENGINE); yarn and pnpm can fail. Running anyway may break at runtime.

Common causes

  • Node too old for a dependency
  • Node too new for a legacy package
  • CI using a different Node version than local

⚡ Quick fix

  1. Switch Node version with nvm (nvm use 20)
  2. Add .nvmrc to the project
  3. Pin Node in CI (setup-node)

Detailed fix by platform

Node.js

  1. echo "20" > .nvmrc && nvm use

How to diagnose

  1. Required — Version range in the message
  2. Current — node -v

🧠 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.