> 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-software.md).

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

Эта страница посвящена установке на **HiveOS**. Для стандартного сервера Ubuntu см. [Установка на Ubuntu](/clore.ai/clore.ai-ru/dlya-khostov/installing-clore-hosting/installing-clore-hosting-ubuntu.md) — команда установки та же; отличается только подготовка ОС.

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

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

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

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

## Рекомендуемые драйверы и CUDA (HiveOS)

HiveOS включает собственное управление драйверами через `nvidia-driver-update` команду. Для лучшей совместимости с нагрузками Clore.ai (особенно ML/AI) используйте следующие рекомендуемые версии:

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

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

Чтобы установить конкретную версию в HiveOS:

```bash
nvidia-driver-update 580.126.18 --force
```

Для GPU серии RTX 50:

```bash
nvidia-driver-update 590.48.01 --force
```

> **Важно:** Не используйте `nvidia-driver-update --force` без указания версии — может установиться более старый драйвер по умолчанию, который не поддерживает современные CUDA-нагрузки.

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

### Совместимость с CUDA Toolkit

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

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

**Рекомендация:** Установите R580 LTSB (580.126.18) для широкой совместимости с нагрузками CUDA 12.x. Если у вас GPU серии RTX 50, используйте R590 (590.48.01) для полной поддержки CUDA 13.x.

## Подготовка рига (HiveOS)

### 1. Откройте Shell рига в HiveOS

Выберите риг в панели HiveOS и откройте **Remote Access → Hive Shell Start** (или подключитесь по SSH).

### 2. Обновите HiveOS

```bash
hive-replace -y --stable
```

#### Если возникнут проблемы с дисковым пространством HiveOS

Если после установки или обновления на диске свободного места меньше, чем ожидалось (например, только 20 ГБ свободно на диске 512 ГБ), выполните следующее:

* **Для M.2:**

  ```bash
  growpart /dev/nvme0n1 4
  resize2fs /dev/nvme0n1p4
  ```
* **Для SATA:**

  ```bash
  growpart /dev/sda 4
  resize2fs /dev/sda4
  ```

### 3. Запустите обновления последовательно

```bash
selfupgrade --force
apt update
apt upgrade
apt autoremove
```

### 4. Обновите драйвер

```bash
nvidia-driver-update 580.126.18 --force
```

Для GPU серии RTX 50 используйте версию `590.48.01` или новее.

### 5. Перезагрузите риг

```bash
reboot
```

## Установка хостинг-агента

Установка выполняется одной командой, которую для вас генерирует панель управления. Установщик автоматически определяет HiveOS — одна и та же команда работает как на Ubuntu, так и на ригах HiveOS.

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

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

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

Чтобы запустить сразу много ригов, используйте раздел **Mass** во всплывающем окне — флоты HiveOS подключаются там через flight sheet; см. [Clore Fleet (массовое подключение)](/clore.ai/clore.ai-ru/dlya-khostov/advanced/clore-fleet-mass-onboarding.md). Чтобы подключить один риг через привязанный аккаунт HiveOS, см. [Интеграция HiveOS](/clore.ai/clore.ai-ru/dlya-khostov/advanced/hiveos-integration.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
```

(В Hive Shell вы обычно уже root.)

Затем вставьте команду, скопированную из панели управления. Если вы использовали путь 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. Завершите настройку

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

```bash
reboot
```

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

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

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

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

   ```bash
   reboot
   ```

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

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

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

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

   ```bash
   reboot
   ```

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

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

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