Подключение сервера

Добавить сервер в панели, выполнить одну команду на сервере и дождаться статуса «Онлайн».

После этой страницы сервер будет подключён к панели и готов принимать проекты. Нужен VPS, который подходит по требованиям, и вход на него по SSH.

Шаги

В панели откройте «Серверы» и нажмите «Добавить сервер». Назовите сервер так, чтобы отличать его от других, например prod-1, и нажмите «Создать и получить токен».

Окно «Новый сервер» в панели с командой установки — Шаг «Установка»: команда для сервера и токен агента. Токен на скрине заменён точками.

Скопируйте команду из блока «Выполните на VPS от root». Она выглядит так, токен и идентификатор у каждого сервера свои:

curl -fsSL https://get.nolay.ru/install.sh | sudo sh -s -- --hub-url wss://api.nolay.ru/agent/v1 --token <токен> --agent-id <uuid>

Войдите на сервер по SSH и выполните команду. Установщик проверит сервер, поставит Docker и агент и в конце напечатает версию агента и состояние службы. Обычно это занимает две-пять минут.
Вернитесь в панель. Шаг «Ожидание агента» проверяет подключение каждые три секунды; когда агент выйдет на связь, нажмите «К серверу». Статус сервера «Онлайн».

Проверить на сервере

Служба работает:

systemctl status nolay-agent

Агент подключился к hub, в журнале есть строка про подключение:

journalctl -u nolay-agent -n 30 --no-pager

Агент не открыл ни одного входящего порта:

ss -tulpn

Где что лежит на сервере

Путь	Что там
`/usr/local/bin/nolay-agent`	бинарник агента
`/etc/nolay/agent.toml`	конфиг агента
`/etc/nolay/agent.token`	токен подключения, права `0600`
`/etc/nolay/agent.key`	ключ шифрования секретов, права `0600`
`/var/lib/nolay`	база агента, исходники сборок, сертификаты Caddy

Обновление

Выполните ту же команду установки ещё раз. Бинарник и служба обновятся, конфиг, данные и контейнеры проектов останутся как были.

Отключение сервера

Откройте настройки сервера в панели и нажмите «Удалить сервер». В окне три пути:

Путь	Что происходит на сервере
Отключить сервер	Агент останавливает контейнеры проектов, сервисов и прокси и снимает себя. Контейнеры, тома, образы и данные остаются. В `/var/lib/nolay/export/` появляются `docker-compose.yml`, файлы `.env` и `README.md`: как поднять проекты обычным Docker
Удалить всё	Агент удаляет контейнеры, сети, тома, образы проектов и прокси, затем снимает себя вместе с конфигом и данными. Перед этим скачайте нужные бэкапы. Нужно ввести имя сервера
Удалить выбранные проекты	Обычное удаление проектов пачкой, у каждого своя галочка «Удалить тома». Сервер остаётся в панели

Если сервер офлайн или агент не ответил, панель всё равно удалит сервер и покажет команду, которую нужно выполнить на сервере от root:

curl -fsSL https://get.nolay.ru/uninstall.sh | sudo sh                # снять агента, данные остаются
curl -fsSL https://get.nolay.ru/uninstall.sh | sudo sh -s -- --purge  # снять агента вместе с конфигом и данными

Без команды из панели контейнеры проектов продолжают работать, пока вы их не остановите. Сертификаты в /var/lib/nolay/caddy сохраняются и после --purge.

Если не получилось

Что видно	Почему	Что сделать
Установщик остановился на проверке	Сервер не подходит или порты заняты	Найдите код проверки в справочнике
Сервер остаётся «Офлайн»	Нет исходящего доступа к `api.nolay.ru:443`	Проверьте файрвол хостинга и `journalctl -u nolay-agent`
В журнале код `4003`	Токен не подходит или отозван	Добавьте сервер заново и выполните новую команду

Что дальше

Создайте первый проект.