Что нужно до старта

Требования к серверу и к проекту, которые проверяются до установки агента.

После этой страницы вы будете знать, подходит ли ваш сервер и ваш проект, и что подготовить до установки агента.

Требования к серверу

Что	Значение
Операционная система	Ubuntu LTS, обкатано на 26.04, или Debian 12 и новее
Архитектура	x86_64. Сборка для aarch64 есть, но живьём не обкатана
Init	systemd
Ресурсы	от 1 vCPU и 1 ГБ памяти
Доступ	root на время установки
Сеть	исходящие соединения наружу, входящие порты открывать не нужно

Мы серверы не продаём и не перепродаём. Машину вы арендуете у любого провайдера, договор на неё у вас с ним.

Swap-файл, если памяти меньше 2 ГБ и swap ещё нет.
Docker из официального репозитория, если его нет на машине.
Движок автодетекта railpack и запасной сборщик nixpacks закреплённых версий.
Системного пользователя nolay в группе docker и каталоги /etc/nolay и /var/lib/nolay.
Образ прокси Caddy, без которого домены и сертификаты не работают.
Сам бинарник агента, unit systemd, правила ufw и fail2ban.

Скрипт идемпотентен: повторный запуск обновляет бинарник и unit, не трогая конфиг и данные и не пересоздавая контейнеры проектов.

Что	Как проверить
Проект запускается локально	Вы знаете команду запуска и порт, на котором приложение отвечает
Стек есть в матрице	Матрица открыта на странице «Поддерживаемые стеки»
Диск сервера с запасом	Образы шаблонов Nolay занимают от 23 до 308 МБ, образы Railpack крупнее

Симптом	Причина	Что сделать
Установщик пишет, что система не поддержана	Дистрибутив не Ubuntu и не Debian	Возьмите машину с Ubuntu LTS
Сборка останавливается на нехватке места	Диску не хватает под образ Railpack	Укажите сборщик `template:<стек>`

Читайте «Подключение сервера».