Поиск
Ошибки

npm WARN EBADENGINE Unsupported engine — пакет требует другую версию Node.js

Пакет сообщает, с какими версиями Node.js и npm он работает, а у вас стоит другая. npm предупреждает и ставит пакет, но запуститься он может с ошибками.

≈ 4 мин чтения
Содержание 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.

Источники

Сверено 22 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше