Коды ошибок

Настройки проекта не прошли проверку агента: поле nolay.toml или формы, имя, ключ или значение. В тексте ошибки перечислены поля.

Что делать. Исправьте названные поля в nolay.toml или в форме проекта и задеплойте снова.

Источник кода не прошёл проверку: неверный адрес или ветка репозитория, либо архив пустой или больше 200 МБ.

Что делать. Проверьте адрес и ветку или загрузите архив заново.

Агент не умеет это действие: версия агента старше панели, стек не распознан или для этого источника действие недоступно.

Что делать. Обновите агент повторным запуском команды установки. Если стек не распознан, добавьте Dockerfile или выберите сборщик вручную.

Непредвиденная ошибка агента при выполнении команды.

Что делать. Повторите действие. Если ошибка повторяется, пришлите в поддержку вывод journalctl -u nolay-agent -n 100.

Агент ещё не знает этот проект: желаемое состояние не дошло до сервера.

Что делать. Подождите минуту и повторите. Если сервер офлайн, сначала верните его на связь.

Деплой отклонён: проект приостановлен. Причина в тексте ошибки.

Что делать. Оплатите тариф, освободите место в лимите или возобновите проект в панели.

Агент не смог получить код: репозиторий или архив недоступен.

Что делать. Проверьте адрес репозитория и исходящую сеть сервера, архив загрузите заново.

Нет доступа к репозиторию.

Что делать. Для GitHub подключите приложение Nolay к репозиторию. Для другого Git добавьте секрет NOLAY_GIT_TOKEN (HTTPS) или NOLAY_GIT_SSH_KEY (SSH).

Ветка или тег не найдены. В тексте ошибки указана ветка по умолчанию.

Что делать. Исправьте ветку в настройках проекта.

В репозитории нет ни одного коммита.

Что делать. Отправьте первый коммит и задеплойте снова.

Агент не смог отдать логи: контейнеров нет или Docker не отвечает.

Что делать. Проверьте, что проект работает, и откройте логи снова.

Бэкапы недоступны: при старте агент не подключился к Docker.

Что делать. Проверьте systemctl status docker и перезапустите агент: systemctl restart nolay-agent.

На сервере недоступен ключ шифрования секретов агента.

Что делать. Запустите команду установки ещё раз: она восстановит /etc/nolay/agent.key, если его нет.

Этот ключ сервиса нельзя показать или изменить.

Что делать. Действие для этого сервиса недоступно.

Сервис не запущен, поэтому пароль сменить нельзя.

Что делать. Запустите сервис и повторите.

Команда смены пароля внутри сервиса завершилась ошибкой, прежний пароль остался в силе.

Что делать. Подробности в событиях сервера.

Агент ещё не запустил этот сервис.

Что делать. Дождитесь запуска сервиса и повторите.

Удалить сервис не получилось.

Что делать. Повторите. Если не помогло, проверьте Docker на сервере.

Агент не на связи, команда не отправлена.

Что делать. Проверьте сервер: systemctl status nolay-agent. Когда он вернётся онлайн, повторите.

Агент не принял команду.

Что делать. Повторите через минуту.

Агент не ответил вовремя.

Что делать. Повторите через минуту. Если повторяется, проверьте нагрузку и сеть сервера.

Версия агента не умеет это действие.

Что делать. Обновите агент повторным запуском команды установки.

Текущее состояние не позволяет действие, например туннель заблокирован администрацией.

Что делать. Подробности в тексте ошибки, при блокировке напишите в поддержку.

Агент подключился с неверным или отозванным токеном.

Что делать. Удалите сервер в панели, создайте заново и выполните новую команду установки.

Слишком много подключений с этого адреса, hub временно отказывает.

Что делать. Агент подключится сам после паузы, делать ничего не нужно.

Сервер удалён в панели, hub закрыл соединение.

Что делать. Если сервер удалён по ошибке, добавьте его заново и выполните новую команду установки.

С тем же идентификатором подключился другой агент.

Что делать. Проверьте, что команду установки не запускали на двух серверах. У каждого сервера своя команда.

Токен не подходит к агенту или отозван.

Что делать. Создайте сервер в панели заново и выполните новую команду установки.

Туннель для сервера не включён.

Что делать. Включите туннель в настройках сервера.

Агент не представился вовремя или не успевает читать сообщения.

Что делать. Агент переподключится сам. Если повторяется, проверьте нагрузку сервера.

Архив больше 200 МБ.

Что делать. Уберите из архива сборки и зависимости, например node_modules.

Формат архива не поддерживается. RAR и 7z не принимаются.

Что делать. Упакуйте код в zip или tar.gz.

Файл пустой.

Что делать. Выберите архив с кодом проекта.

Уже идут три загрузки архивов.

Что делать. Дождитесь деплоя предыдущего архива или повторите позже.

В хранилище загрузок сейчас нет места.

Что делать. Повторите через несколько минут.

Загружать архивы могут владелец и администраторы организации.

Что делать. Попросите владельца выдать вам роль администратора.

Связь оборвалась во время загрузки.

Что делать. Проверьте сеть и загрузите архив снова.

Проект приостановлен: он сверх лимита тарифа.

Что делать. Перейдите на тариф больше или удалите лишние проекты.

Проект приостановлен: подписка не оплачена.

Что делать. Оплатите тариф в разделе «Тариф», проект возобновится.

Проект остановлен администрацией Nolay.

Что делать. Напишите в поддержку.

Деплой завершился ошибкой, прежняя версия продолжает работать.

Что делать. Откройте лог сборки в окне деплоя: последняя строка с ошибкой обычно называет причину.

Проверка готовности не прошла, новая версия не включена.

Что делать. Проверьте порт приложения (run.port) и путь health.path.

Контейнер аварийно завершился.

Что делать. Откройте логи проекта: причина в последних строках.

Фоновый процесс не запустился.

Что делать. Проверьте команду workers.cmd и логи проекта.

Задача по расписанию пропущена: прошлый запуск ещё идёт.

Что делать. Увеличьте интервал или ускорьте задачу.

Бэкап завершился ошибкой.

Что делать. Проверьте секреты NOLAY_S3_* и доступ сервера к хранилищу.

Восстановление из бэкапа завершилось ошибкой.

Что делать. Подробности в событиях проекта.

Сервис каталога не запустился.

Что делать. Проверьте свободную память и диск сервера.

Диск сервера занят больше чем на 85 процентов.

Что делать. Удалите старые образы командой docker image prune или увеличьте диск.

Память сервера занята больше чем на 90 процентов.

Что делать. Уменьшите лимиты проектов или возьмите сервер с большей памятью.

Агент не выходит на связь больше 90 секунд. Проекты при этом продолжают работать.

Что делать. Проверьте, что сервер включён, и выполните systemctl status nolay-agent.

Установка запущена не от root.

Что делать. Запустите команду через sudo.

Архитектура процессора не поддерживается.

Что делать. Возьмите сервер x86_64.

Сервер на ARM. Сборка для aarch64 есть, но живьём не обкатана.

Что делать. Для надёжности возьмите x86_64.

На сервере нет systemd.

Что делать. Возьмите образ Ubuntu LTS или Debian 12.

Операционная система не поддерживается.

Что делать. Переустановите сервер на Ubuntu LTS или Debian 12 и новее.

Версия системы слишком старая.

Что делать. Возьмите Ubuntu 22.04 и новее или Debian 12 и новее.

Памяти меньше 1 ГБ.

Что делать. Возьмите тариф VPS с 1 ГБ памяти и больше.

Свободно меньше 5 ГБ на /var/lib.

Что делать. Освободите место или увеличьте диск.

Порт 80 или 443 занят контейнером Docker.

Что делать. Остановите этот контейнер: порты 80 и 443 нужны прокси Nolay.

Порт 80 или 443 занят веб-сервером. Для apache и других код такой же: port-apache2, port-httpd.

Что делать. Остановите и отключите этот веб-сервер или запустите установку с --fix.

На сервере найдена другая панель хостинга. Для остальных код такой же: panel-dokploy, panel-caprover, panel-plesk, panel-cpanel, panel-ispmanager, panel-aapanel, panel-hestiacp.

Что делать. Nolay не ставится рядом с другой панелью. Возьмите чистый сервер.

Нет доступа к api.nolay.ru.

Что делать. Откройте исходящие соединения на порт 443. Агент встанет, но будет офлайн, пока доступа нет.