Ошибки
Установка упала
install_failed — зависимости не установились. Частые причины и как исправить.
install_failed — npm install, pip install, bundle install или cargo fetch завершились с ошибкой. Сама ошибка — в логе сборки. Если в конце лога есть строка Совет:, она соответствует одному из разделов ниже.
Версии пакетов не сходятся (npm)
В логе ERESOLVE. Два пакета просят разные версии одной библиотеки. Исправьте package.json или укажите в Настройки → Install:
npm install --legacy-peer-deps
Пакет компилируется при установке (npm)
В логе gyp ERR! find Python. Пакеты вроде bcrypt или старого sqlite3 компилируют C-код. Возьмите готовый аналог: bcryptjs вместо bcrypt. Иначе добавьте в проект Dockerfile.
Пакет компилируется при установке (Python)
mysqlclient, psycopg2 и похожие. Мы повторяем установку в образе с компилятором. Если всё равно падает, возьмите вариант без компиляции:
psycopg2-binary # вместо psycopg2
PyMySQL # вместо mysqlclient
Версии в requirements.txt противоречат друг другу
В логе ResolutionImpossible. Ослабьте одну из версий, зафиксированных через ==, например aiogram>=3.4 вместо aiogram==3.4.1.
Пакету нужен более новый Python
В логе Requires-Python >=3.12. Положите в корень проекта файл .python-version:
3.12
Приватный registry просит логин
В логе E401. Добавьте токен в Настройки → Переменные под именем NPM_TOKEN и пропишите в .npmrc:
//registry.npmjs.org/:_authToken=${NPM_TOKEN}
package.json просит версию Node, которой у нас нет
Укажите в devEngines.runtime.version Node 22 или 24 — они у нас есть. Если devEngines называет другой менеджер пакетов, добавьте в package.json "packageManager": "[email protected]" (или yarn@).
Gemfile.lock только для glibc (Ruby)
Сборка идёт на Alpine (musl). Для Rails мы пробуем исправить это сами; если не вышло, выполните один раз и закоммитьте:
bundle lock --add-platform x86_64-linux-musl
Gemfile.lock для старого Ruby
Мы собираем на Ruby 3.3. Выполните bundle update (или обновите гемы, названные в логе) и закоммитьте Gemfile.lock.