> 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-fr/pour-les-hotes/installing-clore-hosting/installing-clore-hosting-ubuntu.md).

# Installation sur Ubuntu

## Exigences du serveur

Le serveur (ou rig – ces termes sont presque interchangeables dans ce contexte) doit être équipé de GPU NVIDIA, car AMD n’est actuellement pas pris en charge. L’espace disque minimal requis est de 32 Go (il est recommandé d’avoir au moins 30 Go d’espace libre sur la partition système) ; pour plus de fiabilité, il est conseillé d’utiliser un SSD plutôt qu’une clé USB. Un minimum de 8 Go de RAM est requis, mais 16 Go offriront une meilleure stabilité. Quant au CPU, le système peut fonctionner avec un Celeron sur socket 1151, mais pour des performances plus efficaces, envisagez d’utiliser un CPU comme l’i7-6700.

Avant de continuer, il est fortement recommandé de désactiver tout overclocking, y compris la limite de puissance (PL), et de réinitialiser les GPU aux paramètres d’usine. Ensuite, testez la stabilité du système en charge, par exemple en testant les GPU avec l’algorithme kawpow et en sollicitant le CPU. Surveillez les températures et assurez-vous que tout fonctionne de manière stable.

Si le système fonctionne de manière stable et que les températures restent dans une plage sûre, passez à l’étape suivante des instructions. Si les températures sont trop élevées ou si des erreurs se produisent, traitez d’abord ces problèmes – par exemple en améliorant le refroidissement ou en procédant au dépannage – et assurez-vous d’un fonctionnement stable avant de continuer.

## OS et pilotes recommandés

### Système d’exploitation

* **Ubuntu 22.04 LTS** — recommandé, meilleure compatibilité avec les pilotes GPU
* **Ubuntu 24.04 LTS** — pris en charge, mais les noyaux 6.16+ peuvent rencontrer des problèmes avec les anciennes branches de pilotes (R550 et inférieures)

{% hint style="warning" %}
L’installateur nécessite une machine **x86\_64** fonctionnant sous **Ubuntu 22.04 ou plus récent** (ou HiveOS — voir [Installation du logiciel](/clore.ai/clore.ai-eng-fr/pour-les-hotes/installing-clore-hosting/installing-clore-hosting-software.md)). Ubuntu 18.04 et 20.04 ne sont plus pris en charge.
{% endhint %}

### Pilotes NVIDIA

L’installateur **ne** n’installe ni ne met à niveau les pilotes GPU — un pilote NVIDIA fonctionnel doit être installé avant de l’exécuter (`nvidia-smi` doit fonctionner).

| Branche     | Version    | Prise en charge CUDA | Recommandé pour                            |
| ----------- | ---------- | -------------------- | ------------------------------------------ |
| R580 (LTSB) | 580.126.18 | Jusqu’à CUDA 12.8    | La plupart des GPU, stabilité à long terme |
| R590        | 590.48.01  | Jusqu’à CUDA 13.1    | Série RTX 50, dernières fonctionnalités    |

Installez le pilote recommandé :

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

Ou pour la série RTX 50 :

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

### CUDA Toolkit (pour les charges de travail ML/IA)

Les locataires exécutant des charges de travail ML s’attendent à CUDA. Versions recommandées :

| Version de CUDA | Pilote min. | Statut                                           |
| --------------- | ----------- | ------------------------------------------------ |
| CUDA 12.8       | R570+       | Stable, large prise en charge de l’écosystème    |
| CUDA 13.1       | R590+       | Dernière version, optimisée pour la série RTX 50 |

La plupart des images Docker incluent leur propre runtime CUDA, donc les hôtes n’ont pas toujours besoin d’installer le CUDA Toolkit à l’échelle du système. Cependant, disposer de pilotes compatibles est essentiel.

## Ajout du serveur

Tout est piloté par une seule commande d’installation générée pour vous par le tableau de bord.

### 1. Créez le serveur sur le site web

Allez sur [clore.ai](https://clore.ai/), inscrivez-vous ou connectez-vous, ouvrez [Mes serveurs](https://clore.ai/my-servers) et cliquez sur **Ajouter un serveur**. Deux options sont disponibles :

* **Rapide** — le tableau de bord affiche une commande prête à copier qui installe l’agent d’hébergement **et** enregistre la machine sur votre compte en une seule étape. Le serveur apparaît automatiquement dans Mes serveurs avec les paramètres par défaut (durée maximale de location de 300 heures, tarification automatique en USD à 5 $ par serveur et par jour pour la demande et le spot), que vous pouvez ajuster ensuite depuis le tableau de bord.
* **Avancé** — vous nommez d’abord le serveur, il apparaît dans Mes serveurs comme en attente d’installation, et la page du serveur affiche les commandes d’installation et d’enregistrement correspondantes (y compris une commande combinée en une ligne avec le jeton de votre serveur).

La section **Massif** de cette même fenêtre couvre le déploiement de flottes entières — voir [Clore Fleet (intégration en masse)](/clore.ai/clore.ai-eng-fr/pour-les-hotes/advanced/clore-fleet-mass-onboarding.md).

### 2. Choisissez un canal d’installation

Les commandes générées sont disponibles en trois canaux :

| Canal      | Ce que c’est                                                                                              |
| ---------- | --------------------------------------------------------------------------------------------------------- |
| **Stable** | Recommandé — versions largement testées, mises à jour moins fréquemment                                   |
| **Bêta**   | Les dernières mises à jour et fonctionnalités avant leur arrivée dans Stable — peuvent être moins fiables |
| **Legacy** | Installateur de génération précédente — solution de repli si Stable ne fonctionne pas sur votre machine   |

Les commandes par canal :

**Stable (recommandé) :**

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

**Bêta :**

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

**Legacy :**

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

Vous pouvez plus tard basculer un serveur en cours d’exécution entre les mises à jour Stable et Beta depuis sa page serveur (nécessite un agent d’hébergement à jour ; impossible pendant que le serveur est loué).

### 3. Exécutez la commande d’installation en tant que root

```bash
sudo -i
```

Collez ensuite la commande copiée depuis le tableau de bord. Si vous avez utilisé le parcours Avancé, ajoutez le jeton affiché sur la page du serveur à la fin pour installer et enregistrer en une seule étape :

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

Si vous avez exécuté la commande d’installation simple sans jeton, enregistrez ensuite la machine avec :

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

L’installateur vérifie ses prérequis dès le départ et vous indique ce qui manque. Il a besoin d’un accès sortant aux dépôts Docker et NVIDIA, à GitHub, GitLab, Docker Hub et `api.clore.ai` — voir [Exigences réseau](/clore.ai/clore.ai-eng-fr/pour-les-hotes/installing-clore-hosting/network-requirements.md).

### 4. Finalisez

Redémarrez le rig, attendez un instant, puis actualisez la page Mes serveurs. Si tout a été configuré correctement, le serveur apparaîtra en ligne.

```bash
redémarrer
```

## Comment désactiver tous les services installés

Si vous devez désactiver tout ce qui a été installé précédemment :

1. Désactivez les services :

   ```bash
   systemctl disable clore-hosting.service
   systemctl disable docker.service
   systemctl disable docker.socket
   ```
2. Redémarrez le système :

   ```bash
   redémarrer
   ```

## Comment réactiver les services

Pour réactiver les services :

1. Activez les services :

   ```bash
   systemctl enable clore-hosting.service
   systemctl enable docker.service
   systemctl enable docker.socket
   ```
2. Redémarrez le système :

   ```bash
   redémarrer
   ```

## Suppression du jeton précédemment installé

Pour supprimer le jeton, utilisez la commande :

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

Le fichier contenant le jeton se trouve à l’emplacement suivant :

```
/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-fr/pour-les-hotes/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.
