> 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 ГБ; для надёжности рекомендуется использовать SSD вместо флеш-накопителя. Требуется минимум 8 ГБ ОЗУ, но 16 ГБ обеспечат большую стабильность. Что касается CPU, система может работать с Celeron на сокете 1151, но для более эффективной работы рассмотрите CPU вроде i7-6700.

Перед продолжением настоятельно рекомендуется отключить любой разгон, включая Power Limit (PL), и вернуть GPU к заводским настройкам. После этого проведите стресс-тест системы на стабильность, например протестируйте GPU с помощью алгоритма 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
```


---

# 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.
