> 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-software.md).
# Installation du logiciel
## 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 minimum requis est de 32 Go ; pour plus de fiabilité, il est recommandé 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 un 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 Power Limit (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 surviennent, corrigez d’abord ces problèmes — par exemple en améliorant le refroidissement ou en dépannant — et assurez-vous d’un fonctionnement stable avant de continuer.
## Pilotes recommandés et CUDA (HiveOS)
HiveOS inclut sa propre gestion des pilotes via la `nvidia-driver-update` commande. Pour une meilleure compatibilité avec les charges de travail Clore.ai (en particulier ML/IA), utilisez les versions recommandées suivantes :
### Pilotes NVIDIA
| Branche | Version | Prise en charge CUDA | Recommandé pour |
| --------------- | ---------- | -------------------- | ------------------------------------------------------------------- |
| **R580 (LTSB)** | 580.126.18 | Jusqu’à CUDA 12.8 | La plupart des GPU — support stable à long terme jusqu’en août 2028 |
| **R590** | 590.48.01 | Jusqu’à CUDA 13.1 | Série RTX 50 (5090/5080), dernières fonctionnalités |
Pour installer une version spécifique dans HiveOS :
```bash
nvidia-driver-update 580.126.18 --force
```
Pour les GPU de la série RTX 50 :
```bash
nvidia-driver-update 590.48.01 --force
```
> **Important :** N’utilisez pas `nvidia-driver-update --force` sans spécifier de version — cela peut installer un ancien pilote par défaut qui ne prend pas en charge les charges de travail CUDA modernes.
### Compatibilité avec le kit d’outils CUDA
La plupart des locataires utilisent des images Docker qui incluent leur propre runtime CUDA, donc les hôtes n’ont généralement pas besoin d’installer manuellement le kit d’outils CUDA. Cependant, **le pilote NVIDIA de l’hôte doit prendre en charge la version de CUDA requise par la charge de travail du locataire.**
| Version de CUDA | Pilote minimal | Statut |
| --------------- | -------------- | ---------------------------------------- |
| CUDA 12.4 | R550+ | Largement utilisé dans l’écosystème ML |
| CUDA 12.8 | R570+ | Dernière branche stable 12.x |
| CUDA 13.1 | R590+ | Dernière, optimisée pour la série RTX 50 |
**Recommandation :** Installez R580 LTSB (580.126.18) pour une large compatibilité avec les charges de travail CUDA 12.x. Si vous hébergez des GPU de la série RTX 50, utilisez R590 (590.48.01) pour une prise en charge complète de CUDA 13.x.
## Inscription et ajout du serveur
### 1. Allez sur le [site web](http://clore.ai/), inscrivez-vous, connectez-vous et accédez au marché :
### 2. **Ajout d’un serveur :** Il existe deux façons d’ajouter un serveur :
**Méthode 1 :** Allez dans la section « Mes serveurs » et cliquez sur le bouton « +Add Server ». Entrez le nom du serveur et cliquez sur « Next ».
Après l’ajout, le serveur sera marqué d’un cercle rouge, ce qui signifie qu’il est inactif. Nous l’activerons plus tard, mais pour l’instant, cliquez sur le serveur créé afin d’obtenir une clé — vous en aurez besoin plus tard.
### 3. Configuration de HiveOS :
Choisissez le rig et ouvrez Shell. Pour ceux qui utilisent rarement HiveOS, des images ont été ajoutées ci-dessous pour plus de clarté.
### 4. **Mise à jour de HiveOS :** Exécutez la commande :
```bash
hive-replace -y --stable
```
#### **Si des problèmes d’espace disque HiveOS surviennent :** S’il reste moins d’espace libre sur le disque que prévu après l’installation ou la mise à jour (par ex. seulement 20 Go libres sur un disque de 512 Go), exécutez ce qui suit :
* **Pour M.2 :**
```bash
growpart /dev/nvme0n1 4
resize2fs /dev/nvme0n1p4
```
* **Pour SATA :**
```bash
growpart /dev/sda 4
resize2fs /dev/sda4
```
### 5. **Exécutez les mises à jour dans l’ordre :**
```bash
selfupgrade --force
apt update
apt upgrade
apt autoremove
```
### 6. **Mettre à jour les pilotes nécessaires :**
```bash
nvidia-driver-update --force
```
> **Astuce :** Pour installer une version spécifique recommandée du pilote, utilisez :
>
> ```bash
> nvidia-driver-update 580.126.18 --force
> ```
>
> Pour les GPU de la série RTX 50, utilisez la version `590.48.01` ou plus récente.
### 7. **Redémarrer le rig :**
```bash
reboot
```
### 8. **Passer en mode superutilisateur :**
```bash
sudo -i
```
### 9. **Installer le logiciel :**
> **Astuce : canaux de l’installateur.** La page d’intégration My Servers génère des commandes d’installation et d’enregistrement en une ligne, prêtes à copier, avec un choix de **Stable** ou **Beta** canal (plus un fallback hérité). Si vous utilisez ces commandes générées, vous pouvez ignorer les étapes d’installation et d’activation manuelles ci-dessous.
```bash
bash <(curl -s https://gitlab.com/cloreai-public/hosting/-/raw/main/install.sh)
```
Si le système indique que `git` est manquant, installez-le avec :
```bash
apt install -y git
```
Puis relancez l’installation.
Si vous rencontrez une erreur `gpg` , utilisez :
```bash
apt install gpg -y --allow-downgrades
```
Ensuite, relancez l’installation.
```
bash <(curl -s https://gitlab.com/cloreai-public/hosting/-/raw/main/install.sh)
```
### 10. **Activer le serveur :**
```bash
/opt/clore-hosting/clore.sh --init-token
```
Remplacez `` par la clé obtenue précédemment.
Si une erreur indique qu’un dossier ou un fichier est manquant, l’installation ne s’est probablement pas terminée correctement, et le dossier `clore-hosting` n’a pas été créé. Dans ce cas, répétez l’installation.
### 11. **Finaliser le redémarrage :**
Redémarrez le rig, attendez un instant, puis actualisez la page du marché. Si tout a été configuré correctement, le serveur sera marqué d’un cercle vert.
```
reboot
```
## Comment désactiver tous les services installés
Si vous devez tout désactiver après installation :
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
reboot
```
## 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
reboot
```
## Suppression du token installé précédemment
Pour supprimer le token, utilisez la commande :
```bash
/opt/clore-hosting/clore.sh --reset
```
Le fichier contenant le token se trouve à :
```
/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-software.md?ask=&goal=
```
`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.
