> For the complete documentation index, see [llms.txt](https://docs.clore.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clore.ai/clore.ai/clore.ai-ru/dlya-khostov/installing-clore-hosting/installing-clore-hosting-ubuntu.md).

# Установка на Ubuntu

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

Сервер (или риг — в этом контексте эти термины почти взаимозаменяемы) должен быть оснащён GPU NVIDIA, так как AMD в настоящее время не поддерживается. Минимально требуемый объём дискового пространства — 32 ГБ (рекомендуется иметь не менее 30 ГБ свободного места на системном разделе); для надёжности рекомендуется использовать SSD вместо флеш-накопителя. Требуется минимум 8 ГБ ОЗУ, но 16 ГБ обеспечат большую стабильность. Что касается CPU, система может работать с Celeron на сокете 1151, но для более эффективной работы рассмотрите процессор вроде i7-6700.

Перед продолжением настоятельно рекомендуется отключить любой разгон, включая Power Limit (PL), и вернуть GPU к заводским настройкам. После этого проверьте систему на стабильность под нагрузкой, например протестируйте GPU с помощью алгоритма kawpow и нагрузите CPU. Отслеживайте температуры и убедитесь, что всё работает стабильно.

Если система работает стабильно, а температуры находятся в безопасном диапазоне, переходите к следующему шагу инструкции. Если температуры слишком высокие или возникают ошибки, сначала устраните эти проблемы — например, улучшите охлаждение или выполните диагностику — и убедитесь в стабильной работе перед продолжением.

## Рекомендуемая ОС и драйверы

### Операционная система

* **Ubuntu 22.04 LTS** — рекомендуется, лучшая совместимость с драйверами GPU
* **Ubuntu 24.04 LTS** — поддерживается, но в ядрах 6.16+ могут быть проблемы со старыми ветками драйверов (R550 и ниже)

{% hint style="warning" %}
Установщик требует **x86\_64** машину под управлением **Ubuntu 22.04 или новее** (или HiveOS — см. [Установка программного обеспечения](/clore.ai/clore.ai-ru/dlya-khostov/installing-clore-hosting/installing-clore-hosting-software.md)). Ubuntu 18.04 и 20.04 больше не поддерживаются.
{% endhint %}

### Драйверы NVIDIA

Установщик **не** устанавливает и не обновляет драйверы GPU — перед запуском должен быть установлен рабочий драйвер NVIDIA (`nvidia-smi` должен работать).

| Ветвь       | Версия     | Поддержка CUDA | Рекомендуется для                          |
| ----------- | ---------- | -------------- | ------------------------------------------ |
| R580 (LTSB) | 580.126.18 | До CUDA 12.8   | Большинство GPU, долгосрочная стабильность |
| R590        | 590.48.01  | До CUDA 13.1   | Серия RTX 50, новейшие функции             |

Установите рекомендуемый драйвер:

```bash
sudo apt install nvidia-driver-580
```

Или для серии RTX 50:

```bash
sudo apt install nvidia-driver-590
```

### CUDA Toolkit (для ML/AI-нагрузок)

Арендаторы, запускающие ML-нагрузки, ожидают CUDA. Рекомендуемые версии:

| Версия CUDA | Мин. драйвер | Статус                                            |
| ----------- | ------------ | ------------------------------------------------- |
| CUDA 12.8   | R570+        | Стабильная, широкая поддержка экосистемы          |
| CUDA 13.1   | R590+        | Последняя версия, оптимизирована для серии RTX 50 |

Большинство Docker-образов включают собственную среду выполнения CUDA, поэтому хостам не всегда нужно устанавливать CUDA Toolkit на уровне системы. Однако совместимые драйверы необходимы.

## Добавление сервера

Всё управляется одной командой установки, которую панель управления генерирует для вас.

### 1. Создайте сервер на сайте

Перейдите на [clore.ai](https://clore.ai/), зарегистрируйтесь или войдите в систему, откройте [Мои серверы](https://clore.ai/my-servers) и нажмите **Добавить сервер**. Доступны два пути:

* **Быстрый** — панель покажет одну готовую к копированию команду, которая устанавливает агент хостинга **и** регистрирует машину в вашей учётной записи за один шаг. Сервер автоматически появится в разделе «Мои серверы» с настройками по умолчанию (максимальная длительность аренды 300 часов, автопрайсинг в USD по $5 за сервер в день для on-demand и spot), которые затем можно изменить в панели управления.
* **Расширенный** — сначала вы задаёте имя серверу, он появляется в «Мои серверы» как ожидающий установки, а на странице сервера отображаются команды установки и регистрации для него (включая объединённую однострочную команду с токеном вашего сервера).

В той же модальной форме раздел **Массовый** охватывает запуск целых флотилий — см. [Clore Fleet (массовое подключение)](/clore.ai/clore.ai-ru/dlya-khostov/advanced/clore-fleet-mass-onboarding.md).

### 2. Выберите канал установщика

Сгенерированные команды доступны в трёх каналах:

| Канал      | Что это                                                                                      |
| ---------- | -------------------------------------------------------------------------------------------- |
| **Stable** | Рекомендуется — тщательно протестированные релизы, обновляются реже                          |
| **Beta**   | Самые новые обновления и функции до их попадания в Stable — могут быть менее надёжными       |
| **Legacy** | Установщик предыдущего поколения — запасной вариант, если Stable не работает на вашей машине |

Команды для каждого канала:

**Stable (рекомендуется):**

```bash
bash <(curl -s https://gitlab.com/cloreai-public/hosting-agent-installer/-/raw/main/install.sh)
```

**Beta:**

```bash
bash <(curl -s https://gitlab.com/cloreai-public/hosting-agent-installer/-/raw/dev/install.sh) --channel beta
```

**Legacy:**

```bash
bash <(curl -s https://gitlab.com/cloreai-public/hosting-agent-installer/-/raw/legacy/install.sh)
```

Позже вы можете переключать работающий сервер между обновлениями Stable и Beta со страницы сервера (требуется актуальный агент хостинга; это невозможно, пока сервер сдан в аренду).

### 3. Запустите команду установки от root

```bash
sudo -i
```

Затем вставьте команду, скопированную из панели управления. Если вы использовали путь Advanced, добавьте токен, показанный на странице сервера, чтобы установить и зарегистрировать всё за один шаг:

```bash
bash <(curl -s https://gitlab.com/cloreai-public/hosting-agent-installer/-/raw/main/install.sh) --init-token <token>
```

Если вы запустили обычную команду установки без токена, зарегистрируйте машину после этого с помощью:

```bash
/opt/clore-hosting/clore.sh --init-token <token>
```

Установщик заранее проверяет необходимые условия и сообщает, чего не хватает. Ему нужен исходящий доступ к репозиториям Docker и NVIDIA, GitHub, GitLab, Docker Hub и `api.clore.ai` — см. [Требования к сети](/clore.ai/clore.ai-ru/dlya-khostov/installing-clore-hosting/network-requirements.md).

### 4. Завершение

Перезагрузите риг, подождите немного и обновите страницу «Мои серверы». Если всё было настроено правильно, сервер будет отображаться как онлайн.

```bash
перезагрузка
```

## Как отключить все установленные службы

Если нужно отключить всё, что было установлено ранее:

1. Отключите службы:

   ```bash
   systemctl disable clore-hosting.service
   systemctl disable docker.service
   systemctl disable docker.socket
   ```
2. Перезагрузите систему:

   ```bash
   перезагрузка
   ```

## Как снова включить службы

Чтобы снова включить службы:

1. Включите службы:

   ```bash
   systemctl enable clore-hosting.service
   systemctl enable docker.service
   systemctl enable docker.socket
   ```
2. Перезагрузите систему:

   ```bash
   перезагрузка
   ```

## Удаление ранее установленного токена

Чтобы удалить токен, используйте команду:

```bash
/opt/clore-hosting/clore.sh --reset
```

Файл, содержащий токен, находится по адресу:

```
/opt/clore-hosting/client/auth
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.clore.ai/clore.ai/clore.ai-ru/dlya-khostov/installing-clore-hosting/installing-clore-hosting-ubuntu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.