> 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-eng-es/para-hosts/installing-clore-hosting/installing-clore-hosting-software.md).

# Instalación en HiveOS

Esta página cubre la instalación en **HiveOS**. Para un servidor Ubuntu estándar, consulte [Instalación en Ubuntu](/clore.ai/clore.ai-eng-es/para-hosts/installing-clore-hosting/installing-clore-hosting-ubuntu.md) — el comando de instalación es el mismo; solo cambia la preparación del sistema operativo.

## Requisitos del servidor

El servidor (o rig — estos términos son casi intercambiables en este contexto) debe estar equipado con GPUs NVIDIA, ya que AMD actualmente no está soportado. El espacio mínimo requerido en disco es de 32 GB (se recomienda disponer de al menos 30 GB libres en la partición del sistema); por fiabilidad, se recomienda usar un SSD en lugar de una memoria flash. Se requiere un mínimo de 8 GB de RAM, pero 16 GB proporcionarán mayor estabilidad. En cuanto a la CPU, el sistema puede funcionar con un Celeron en un socket 1151, pero para un rendimiento más eficiente, considere usar una CPU como la i7-6700.

Antes de continuar, se recomienda encarecidamente desactivar cualquier overclocking, incluido el Power Limit (PL), y restablecer las GPUs a la configuración de fábrica. Después, pruebe la estabilidad del sistema con esfuerzo, por ejemplo, probando las GPUs con el algoritmo kawpow y cargando la CPU. Supervise las temperaturas y asegúrese de que todo funcione de forma estable.

Si el sistema funciona de forma estable y las temperaturas están dentro de un rango seguro, continúe con el siguiente paso de las instrucciones. Si las temperaturas son demasiado altas o se producen errores, resuelva primero estos problemas — por ejemplo, mejorando la refrigeración o solucionando fallos — y asegúrese de que el funcionamiento sea estable antes de continuar.

## Controladores recomendados y CUDA (HiveOS)

HiveOS incluye su propia gestión de controladores mediante el `nvidia-driver-update` comando. Para obtener la mejor compatibilidad con las cargas de trabajo de Clore.ai (especialmente ML/IA), use las siguientes versiones recomendadas:

### Controladores NVIDIA

| Rama            | Versión    | Compatibilidad con CUDA | Recomendado para                                                          |
| --------------- | ---------- | ----------------------- | ------------------------------------------------------------------------- |
| **R580 (LTSB)** | 580.126.18 | Hasta CUDA 12.8         | La mayoría de las GPUs — soporte estable a largo plazo hasta ago. de 2028 |
| **R590**        | 590.48.01  | Hasta CUDA 13.1         | Serie RTX 50 (5090/5080), últimas funciones                               |

Para instalar una versión específica en HiveOS:

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

Para GPUs de la serie RTX 50:

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

> **Importante:** No use `nvidia-driver-update --force` sin especificar una versión — puede instalar un controlador predeterminado más antiguo que no admita cargas de trabajo modernas de CUDA.

El instalador en sí **no** instala ni actualiza controladores de GPU — debe haber un controlador NVIDIA funcional instalado antes de ejecutarlo (`nvidia-smi` debe funcionar).

### Compatibilidad con el kit de herramientas CUDA

La mayoría de los inquilinos usan imágenes Docker que incluyen su propio runtime de CUDA, por lo que normalmente los hosts no necesitan instalar manualmente el kit de herramientas CUDA. Sin embargo, **el controlador NVIDIA del host debe admitir la versión de CUDA requerida por la carga de trabajo del inquilino.**

| Versión de CUDA | Controlador mínimo | Estado                                           |
| --------------- | ------------------ | ------------------------------------------------ |
| CUDA 12.4       | R550+              | Ampliamente usado en el ecosistema de ML         |
| CUDA 12.8       | R570+              | Rama 12.x estable más reciente                   |
| CUDA 13.1       | R590+              | Lo más reciente, optimizado para la serie RTX 50 |

**Recomendación:** Instale R580 LTSB (580.126.18) para una amplia compatibilidad con cargas de trabajo CUDA 12.x. Si aloja GPUs de la serie RTX 50, use R590 (590.48.01) para compatibilidad completa con CUDA 13.x.

## Preparando el rig (HiveOS)

### 1. Abra la Shell del rig en HiveOS

Elija el rig en el panel de HiveOS y abra **Acceso remoto → Iniciar Hive Shell** (o conéctese por SSH).

### 2. Actualice HiveOS

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

#### Si surgen problemas de espacio en disco en HiveOS

Si queda menos espacio libre en el disco del esperado después de la instalación o actualización (por ejemplo, solo 20 GB libres en un disco de 512 GB), ejecute lo siguiente:

* **Para M.2:**

  ```bash
  growpart /dev/nvme0n1 4
  resize2fs /dev/nvme0n1p4
  ```
* **Para SATA:**

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

### 3. Ejecute las actualizaciones en secuencia

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

### 4. Actualice el controlador

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

Para GPUs de la serie RTX 50, use la versión `590.48.01` o posterior.

### 5. Reinicie el rig

```bash
reboot
```

## Instalación del agente de hosting

La instalación es un solo comando, generado para usted por el panel. El instalador detecta HiveOS automáticamente: el mismo comando funciona tanto en rigs Ubuntu como HiveOS.

### 1. Cree el servidor en el sitio web

Vaya a [clore.ai](https://clore.ai/), regístrese o inicie sesión, abra [Mis servidores](https://clore.ai/my-servers) y haga clic en **Añadir servidor**:

* **Rápido** — un comando que instala el agente de hosting **y** registra la máquina en su cuenta en un solo paso, con la configuración predeterminada (duración máxima de alquiler de 300 horas, precios automáticos en USD a 5 $ por servidor al día para on-demand y spot) que luego puede ajustar desde el panel.
* **Avanzado** — primero nombre el servidor y luego copie sus comandos de instalación y registro (incluida una línea única combinada con el token del servidor) desde la página del servidor.

Para poner en marcha muchos rigs a la vez, use la **Masivo** sección del modal en su lugar — las flotas de HiveOS se incorporan allí mediante una flight sheet; consulte [Clore Fleet (incorporación masiva)](/clore.ai/clore.ai-eng-es/para-hosts/advanced/clore-fleet-mass-onboarding.md). Para incorporar un solo rig a través de su cuenta de HiveOS vinculada, consulte [Integración con HiveOS](/clore.ai/clore.ai-eng-es/para-hosts/advanced/hiveos-integration.md).

### 2. Elija un canal del instalador

| Canal        | Qué es                                                                                       |
| ------------ | -------------------------------------------------------------------------------------------- |
| **Estable**  | Recomendado — versiones ampliamente probadas, actualizadas con menos frecuencia              |
| **Beta**     | Las novedades y funciones más recientes antes de llegar a Estable — pueden ser menos fiables |
| **Herencia** | Instalador de la generación anterior — una alternativa si Estable no funciona en su equipo   |

**Estable (recomendado):**

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

**Herencia:**

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

Más adelante puede cambiar un servidor en ejecución entre las actualizaciones Estable y Beta desde su página de servidor (requiere un agente de hosting actualizado; no es posible mientras el servidor está alquilado).

### 3. Ejecute el comando de instalación como root

```bash
sudo -i
```

(En Hive Shell normalmente ya es root.)

Luego pegue el comando copiado desde el panel. Si usó la ruta Avanzado, añada el token mostrado en la página del servidor para instalar y registrar en un solo paso:

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

Si ejecutó el comando de instalación simple sin un token, registre la máquina después con:

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

El instalador comprueba sus requisitos previos por adelantado y le indica qué falta. Necesita acceso saliente a los repositorios de paquetes de Docker y NVIDIA, GitHub, GitLab, Docker Hub y `api.clore.ai` — consulte [Requisitos de red](/clore.ai/clore.ai-eng-es/para-hosts/installing-clore-hosting/network-requirements.md).

### 4. Finalice

Reinicie el rig, espere un momento y actualice la página Mis servidores. Si todo se configuró correctamente, el servidor aparecerá en línea.

```bash
reboot
```

## Cómo deshabilitar todos los servicios instalados

Si necesita deshabilitar todo lo instalado previamente:

1. Deshabilite los servicios:

   ```bash
   systemctl disable clore-hosting.service
   systemctl disable docker.service
   systemctl disable docker.socket
   ```
2. Reinicie el sistema:

   ```bash
   reboot
   ```

## Cómo volver a habilitar los servicios

Para volver a habilitar los servicios:

1. Habilite los servicios:

   ```bash
   systemctl enable clore-hosting.service
   systemctl enable docker.service
   systemctl enable docker.socket
   ```
2. Reinicie el sistema:

   ```bash
   reboot
   ```

## Eliminar el token instalado previamente

Para eliminar el token, use el comando:

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

El archivo que contiene el token se encuentra en:

```
/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-eng-es/para-hosts/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.