> 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 sur HiveOS Cette page couvre l’installation sur **HiveOS**. Pour un serveur Ubuntu standard, voir [Installation sur Ubuntu](/clore.ai/clore.ai-eng-fr/pour-les-hotes/installing-clore-hosting/installing-clore-hosting-ubuntu.md) — la commande d’installation est la même ; seule la préparation du système d’exploitation diffère. ## Configuration requise 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 (il est recommandé d’avoir au moins 30 Go libres sur la partition système) ; 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 socket 1151, mais pour des performances plus efficaces, envisagez d’utiliser un CPU comme le 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 sous charge, par exemple en testant les GPU avec l’algorithme kawpow et en chargeant 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 effectuant un dépannage — et assurez-vous que le système fonctionne de manière stable avant de continuer. ## Pilotes et CUDA recommandés (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 — stable, prise en charge à 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. L’installateur lui-même n’ **installe pas** ni ne met à niveau les pilotes GPU — un pilote NVIDIA fonctionnel doit être installé avant de l’exécuter (`nvidia-smi` doit fonctionner). ### Compatibilité du 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 CUDA requise par la charge de travail du locataire.** | Version CUDA | Pilote minimum | 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 version, 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. ## Préparation du rig (HiveOS) ### 1. Ouvrez le shell du rig dans HiveOS Choisissez le rig dans le tableau de bord HiveOS et ouvrez **Accès à distance → Hive Shell Start** (ou connectez-vous en SSH). ### 2. Mettez HiveOS à jour ```bash hive-replace -y --stable ``` #### En cas de problème d’espace disque avec HiveOS S’il reste moins d’espace libre sur le disque que prévu après l’installation ou la mise à jour (par exemple, 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 ``` ### 3. Exécutez les mises à jour dans l’ordre ```bash selfupgrade --force apt update apt upgrade apt autoremove ``` ### 4. Mettez le pilote à jour ```bash nvidia-driver-update 580.126.18 --force ``` Pour les GPU de la série RTX 50, utilisez la version `590.48.01` ou ultérieure. ### 5. Redémarrez le rig ```bash reboot ``` ## Installation de l’agent d’hébergement L’installation se fait en une seule commande, générée pour vous par le tableau de bord. L’installateur détecte HiveOS automatiquement — la même commande fonctionne aussi bien sur Ubuntu que sur les rigs HiveOS. ### 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**: * **Rapide** — une commande qui installe l’agent d’hébergement **et** enregistre la machine sur votre compte en une seule étape, avec les paramètres par défaut (durée maximale de location 300 heures, tarification automatique en USD à 5 $ par serveur et par jour pour la demande et le spot) que vous pourrez ajuster ensuite depuis le tableau de bord. * **Avancé** — nommez d’abord le serveur, puis copiez ses commandes d’installation et d’enregistrement (y compris une ligne unique combinée avec le jeton du serveur) depuis la page du serveur. Pour mettre en service plusieurs rigs à la fois, utilisez plutôt la section **Masse** du modal — les flottes HiveOS sont intégrées via une flight sheet à cet endroit ; voir [Clore Fleet (intégration massive)](/clore.ai/clore.ai-eng-fr/pour-les-hotes/advanced/clore-fleet-mass-onboarding.md). Pour intégrer un seul rig via votre compte HiveOS lié, voir [Intégration HiveOS](/clore.ai/clore.ai-eng-fr/pour-les-hotes/advanced/hiveos-integration.md). ### 2. Choisissez un canal d’installation | Canal | Ce que c’est | | ---------- | ------------------------------------------------------------------------------------------------------- | | **Stable** | Recommandé — versions largement testées, mises à jour moins fréquentes | | **Bêta** | 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 | **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 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 ``` (Dans Hive Shell, vous êtes généralement déjà root.) 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 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 ``` 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 ``` L’installateur vérifie d’emblée ses prérequis 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 reboot ``` ## 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 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 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 : ``` /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.