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

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

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

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

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

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

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

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

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

| Ветка       | Версия     | Поддержка 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. Перейдите на [веб-сайт](http://clore.ai/), зарегистрируйтесь, войдите и перейдите на маркетплейс:

<figure><img src="https://img1.teletype.in/files/0e/86/0e86de72-544d-48d8-8d82-cf120e516a81.png" alt=""><figcaption></figcaption></figure>

### 2. **Добавление сервера:** Существует два способа добавить сервер:

**Метод 1:** Перейдите в раздел «Мои серверы» и нажмите кнопку «+Добавить сервер». Введите имя сервера и нажмите «Далее».

<figure><img src="https://img4.teletype.in/files/f7/8e/f78e0a46-06fa-4a5d-b429-f21b78eafb6c.png" alt=""><figcaption></figcaption></figure>

После добавления сервер будет отмечен красным кружком, что означает неактивность. Мы активируем его позже, а пока нажмите на созданный сервер, чтобы получить ключ — он понадобится вам позже.

<figure><img src="https://img4.teletype.in/files/36/ae/36aeeab8-98e0-4fea-81e9-d731d5211df2.png" alt=""><figcaption></figcaption></figure>

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

```bash
sudo apt update && sudo apt upgrade -y
```

### 4. Установите зависимости:

```
sudo apt install -y curl git gnupg lsb-release
```

### 5. Переключитесь в режим суперпользователя:

```bash
sudo -i
```

### 6. **Установите программное обеспечение:**

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

Если система сообщает, что `git` отсутствует, установите его с помощью:

```bash
apt install -y git
```

Затем повторите установку.

Если вы столкнулись с `gpg` ошибкой, используйте:

<figure><img src="https://telegra.ph/file/e2ef8c5760193ad523e20.png" alt=""><figcaption></figcaption></figure>

```bash
apt install gpg -y --allow-downgrades
```

<figure><img src="https://img3.teletype.in/files/66/1c/661c9073-cc8e-4734-aa85-cff08902d4d6.png" alt=""><figcaption></figcaption></figure>

После этого повторно запустите установку.

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

### 7. **Активируйте сервер:**

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

Замените `<token>` на ключ, полученный ранее.

Если ошибка указывает на отсутствие папки или файла, вероятно, установка не завершилась корректно, и папка `clore-hosting` не была создана. В этом случае повторите установку.

### 8. **Завершение:**

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

```
sudo reboot
```

<figure><img src="https://img2.teletype.in/files/98/9c/989c1cbd-2670-4568-b784-020af71451be.png" alt=""><figcaption></figcaption></figure>

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

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

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