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

# Instalación en Ubuntu

## Requisitos del servidor

El servidor (o equipo — estos términos son casi intercambiables en este contexto) debe estar equipado con GPUs NVIDIA, ya que AMD actualmente no es compatible. El espacio mínimo de disco requerido es de 32 GB (se recomienda tener 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, considera 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, somete el sistema a una prueba de estrés para comprobar su estabilidad, por ejemplo, probando las GPUs con el algoritmo kawpow y cargando la CPU. Supervisa las temperaturas y asegúrate de que todo esté funcionando de forma estable.

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

## SO y controladores recomendados

### Sistema operativo

* **Ubuntu 22.04 LTS** — recomendado, mejor compatibilidad con controladores de GPU
* **Ubuntu 24.04 LTS** — compatible, pero los kernels 6.16+ pueden tener problemas con ramas antiguas de controladores (R550 y anteriores)

{% hint style="warning" %}
El instalador requiere una **x86\_64** máquina que ejecute **Ubuntu 22.04 o más reciente** (o HiveOS — ver [Instalación del software](/clore.ai/clore.ai-eng-es/para-hosts/installing-clore-hosting/installing-clore-hosting-software.md)). Ubuntu 18.04 y 20.04 ya no son compatibles.
{% endhint %}

### Controladores NVIDIA

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

| Rama        | Versión    | Compatibilidad con CUDA | Recomendado para                                  |
| ----------- | ---------- | ----------------------- | ------------------------------------------------- |
| R580 (LTSB) | 580.126.18 | Hasta CUDA 12.8         | La mayoría de las GPUs, estabilidad a largo plazo |
| R590        | 590.48.01  | Hasta CUDA 13.1         | Serie RTX 50, funciones más recientes             |

Instala el controlador recomendado:

```bash
sudo apt install nvidia-driver-580
```

O para la serie RTX 50:

```bash
sudo apt install nvidia-driver-590
```

### CUDA Toolkit (para cargas de trabajo de ML/IA)

Los arrendatarios que ejecutan cargas de trabajo de ML esperan CUDA. Versiones recomendadas:

| Versión de CUDA | Controlador mínimo | Estado                                           |
| --------------- | ------------------ | ------------------------------------------------ |
| CUDA 12.8       | R570+              | Estable, amplio soporte del ecosistema           |
| CUDA 13.1       | R590+              | Lo más reciente, optimizado para la serie RTX 50 |

La mayoría de las imágenes de Docker incluyen su propio entorno de ejecución de CUDA, por lo que los hosts no siempre necesitan instalar el CUDA Toolkit en todo el sistema. Sin embargo, es esencial contar con controladores compatibles.

## Añadir el servidor

Todo se gestiona mediante un único comando de instalación que el panel genera para ti.

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

Ve a [clore.ai](https://clore.ai/), regístrate o inicia sesión, abre [Mis servidores](https://clore.ai/my-servers) y haz clic en **Añadir servidor**. Hay dos rutas disponibles:

* **Rápida** — el panel muestra un comando listo para copiar que instala el agente de alojamiento **y** registra la máquina en tu cuenta en un solo paso. El servidor aparece automáticamente en Mis servidores con la configuración predeterminada (duración máxima de alquiler 300 horas, precios automáticos en USD a $5 por servidor por día para on-demand y spot), que luego puedes ajustar desde el panel.
* **Avanzada** — primero nombras el servidor, aparece en Mis servidores como pendiente de instalación, y la página del servidor muestra los comandos de instalación y registro para él (incluido un one-liner combinado con el token de tu servidor).

La sección **Masiva** del mismo cuadro cubre la puesta en marcha de flotas completas — ver [Clore Fleet (alta masiva)](/clore.ai/clore.ai-eng-es/para-hosts/advanced/clore-fleet-mass-onboarding.md).

### 2. Elige un canal del instalador

Los comandos generados vienen en tres canales:

| Canal       | Qué es                                                                                          |
| ----------- | ----------------------------------------------------------------------------------------------- |
| **Estable** | Recomendado — versiones exhaustivamente probadas, actualizadas con menos frecuencia             |
| **Beta**    | Las actualizaciones y funciones más nuevas antes de llegar a Estable — pueden ser menos fiables |
| **Legado**  | Instalador de la generación anterior — una alternativa si Estable no funciona en tu máquina     |

Los comandos por canal:

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

**Legado:**

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

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

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

```bash
sudo -i
```

Luego pega el comando copiado del panel. Si usaste la ruta Avanzada, añade el token que se muestra 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 ejecutaste el comando de instalación sin un token, registra la máquina después con:

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

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

### 4. Finalizar

Reinicia el equipo, espera un momento y actualiza la página Mis servidores. Si todo se configuró correctamente, el servidor aparecerá en línea.

```bash
reiniciar
```

## Cómo deshabilitar todos los servicios instalados

Si necesitas deshabilitar todo lo instalado previamente:

1. Deshabilita los servicios:

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

   ```bash
   reiniciar
   ```

## Cómo volver a habilitar los servicios

Para volver a habilitar los servicios:

1. Habilita los servicios:

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

   ```bash
   reiniciar
   ```

## Eliminación del token instalado previamente

Para borrar el token, usa 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-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.