npm WARN EBADENGINE Unsupported engine — пакет требует другую версию Node.js
Пакет сообщает, с какими версиями Node.js и npm он работает, а у вас стоит другая. npm предупреждает и ставит пакет, но запуститься он может с ошибками.
Содержание 7
Как выглядит предупреждение
npm WARN EBADENGINE Unsupported engine {
npm WARN EBADENGINE package: 'example-pkg@3.0.0',
npm WARN EBADENGINE required: { node: '>=20' },
npm WARN EBADENGINE current: { node: 'v18.19.1', npm: '9.2.0' }
npm WARN EBADENGINE }example-pkg — условное имя, у вас будет свой пакет. Тексты сверены с исходным кодом npm 9.2.0 — эта версия ставится из пакетов Ubuntu 24.04 и 26.04 — и npm 10.9.4, который идёт вместе с Node.js 22.22.1 с сайта nodejs.org. В npm 10 строки начинаются с npm error вместо npm ERR!, а предупреждения — с npm warn вместо npm WARN.
| Строка | Что значит |
|---|---|
package | какой пакет и какой версии ставится |
required | какие версии ему нужны: >=20 — Node.js 20 или новее |
current | что стоит у вас: Node.js 18.19.1 и npm 9.2.0 |
Если в настройках npm включён параметр engine-strict, это уже ошибка, и пакет не ставится:
npm ERR! code EBADENGINE
npm ERR! engine Unsupported engine
npm ERR! engine Not compatible with your version of node/npm: example-pkg@3.0.0
npm ERR! notsup Not compatible with your version of node/npm: example-pkg@3.0.0
npm ERR! notsup Required: {"node":">=20"}
npm ERR! notsup Actual: {"npm":"9.2.0","node":"v18.19.1"}Способ 1. Поставьте подходящую версию Node.js
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
Проверьте свою версию:
node -vВ Ubuntu 24.04 из пакетов ставится Node.js 18, в Ubuntu 26.04 — Node.js 22, а если пакету нужна версия новее, чем в пакетах вашей Ubuntu, поставьте Node.js с сайта проекта — как поставить версию новее. После смены версии переустановите пакеты проекта:
cd /home/ivan/myapp
rm -rf node_modules
npm installКоманда rm удаляет папку node_modules без вопросов — проверьте, что вы в папке проекта.
Способ 2. Поставьте версию пакета для вашего Node.js
Посмотрите, какие версии пакета есть:
npm view example-pkg versionsИ какую версию Node.js требует, например, вторая версия пакета:
npm view example-pkg@2 enginesЕсли ваша версия подходит, поставьте её:
npm install example-pkg@2Можно ли не обращать внимания
Предупреждение не останавливает установку, и пакет может работать. Но автор пакета не проверял его на вашей версии Node.js: при запуске могут появиться ошибки, которых нет в описании пакета. Если приложение после установки падает, начните с этого предупреждения.
Как проверить
cd /home/ivan/myapp
npm installВ выводе не должно быть строк EBADENGINE.
Источники
- Исходный код npm-install-checks 6.0.0 из npm 9.2.0 — проверка engines, текст Unsupported engine, поля required и current.
- Исходный код npm 9.2.0: build-ideal-tree.js — без engine-strict несовпадение выводится предупреждением.
- Исходный код npm 9.2.0: lib/utils/error-message.js — строки engine и notsup при ошибке EBADENGINE.
- Исходный код npm 10.9.4: lib/utils/display.js — в npm 10 строки начинаются с
npm errorиnpm warn. - Документация npm 10: config — параметр engine-strict.
Сверено 22 октября 2026 года.
Что почитать дальше
- Как установить Node.js на Ubuntuверсии из пакетов и с nodejs.org.
- npm: ERESOLVEконфликт версий пакетов.
- Все ошибки Node.js и npmтаблица по тексту сообщения.