# Установка на 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/), зарегистрируйтесь, войдите и перейдите на маркетплейс:
### 2. **Добавление сервера:** Существует два способа добавить сервер:
**Метод 1:** Перейдите в раздел «Мои серверы» и нажмите кнопку «+Добавить сервер». Введите имя сервера и нажмите «Далее».
После добавления сервер будет отмечен красным кружком, что означает неактивность. Мы активируем его позже, а пока нажмите на созданный сервер, чтобы получить ключ — он понадобится вам позже.
### 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` ошибкой, используйте:
```bash
apt install gpg -y --allow-downgrades
```
После этого повторно запустите установку.
```
bash <(curl -s https://gitlab.com/cloreai-public/hosting/-/raw/main/install.sh)
```
### 7. **Активируйте сервер:**
```bash
/opt/clore-hosting/clore.sh --init-token
```
Замените `` на ключ, полученный ранее.
Если ошибка указывает на отсутствие папки или файла, вероятно, установка не завершилась корректно, и папка `clore-hosting` не была создана. В этом случае повторите установку.
### 8. **Завершение:**
Перезагрузите риг, подождите немного и обновите страницу маркетплейса. Если всё настроено правильно, сервер будет отмечен зелёным кружком.
```
sudo 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: 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:
```
GET https://docs.clore.ai/clore.ai/clore.ai-ru/dlya-khostov/installing-clore-hosting/installing-clore-hosting-ubuntu.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.
