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

URL: https://docs.nolay.ru/start/connect-server/
Updated: 2026-09-23

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

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

## Шаги

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

![Шаг «Установка»: команда для сервера и токен агента. Токен на скрине заменён точками.](https://docs.nolay.ru/shots/ru/servers-new-light.png)

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

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

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

4. Вернитесь в панель. Шаг «Ожидание агента» проверяет подключение каждые три секунды; когда агент выйдет на связь, нажмите «К серверу». Статус сервера «Онлайн».

> **Токен показывается один раз**
>
> Панель токен не хранит. Если страница закрылась до установки, выпустите новый токен в настройках сервера и возьмите новую команду.

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

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

```sh
systemctl status nolay-agent
```

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

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

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

```sh
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:

```sh
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`.

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

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

## Что дальше

Создайте [первый проект](/start/first-project/).