> 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/server-offline-on-clore.ai/docker-failure.md).

# Échec de Docker

**Problème**\
Clore.ai marque le rig comme *Échec Docker* et le maintient hors ligne, même si HiveOS fonctionne.

**Symptômes**

* Une icône « Échec Docker » est affichée dans le panneau Clore.
* Dans **Mes serveurs** section, les GPU sont affichés comme *0x Inconnu* ou le nombre de GPU continue de changer.

***

**Cause 1 : GPU ou riser instable**

Clore ne peut pas initialiser un GPU s'il est déconnecté ou instable.\
Même si HiveOS voit le GPU, Clore ne peut pas l'utiliser → **Échec Docker**.

**Solution : Redémarrer et vérifier le matériel**

1. Vérifiez le GPU ou le riser, assurez-vous que tout est correctement connecté.
2. Redémarrez le rig :

```
reboot
```

Si l'erreur revient après le redémarrage, le problème vient probablement du GPU, de la carte mère ou des risers.

***

#### Cause 2 : environnement Python corrompu (Miniconda)

Clore se bloque au démarrage si le répertoire `/opt/clore-hosting/miniconda-env` est corrompu.

**Solution : Supprimer l'environnement et redémarrer**

```
sudo systemctl stop clore-hosting.service
sudo rm -rf /opt/clore-hosting/miniconda-env
sudo systemctl start clore-hosting.service
```

***

#### Cause 3 : l'installation des dépendances est bloquée

Si Clore ne démarre pas, cela peut être dû à une installation gelée des dépendances (p.ex. aiofiles, docker, etc.).

**Solution : Réinstaller les dépendances**

```
sudo /opt/clore-hosting/clore.sh --reinstall
```

***

#### Cause 4 : version de Docker installée instable (p.ex. 28.\*)

Version recommandée : **27.5.1**\
Les plantages sont courants avec Docker 28+.

**Solution : Rétrograder Docker**

```bash
sudo apt install \
docker-ce=5:27.5.1-1~ubuntu.22.04~jammy \
docker-ce-cli=5:27.5.1-1~ubuntu.22.04~jammy \
containerd.io -y
```

***

#### Cause 5 : services requis non activés au démarrage

Après le redémarrage, le système ne lance pas Docker et Clore Hosting → le serveur passe hors ligne.

**Solution : Activer les services au démarrage**

```
sudo systemctl enable clore-hosting.service
sudo systemctl enable docker.service
sudo systemctl enable docker.socket
```

***

#### Cause 6 : le pilote ne détecte pas les GPU (`nvidia-smi → Aucun périphérique trouvé`)

Si HiveOS ne détecte pas le GPU, Clore ne peut pas travailler avec lui → cela entraîne un Échec Docker.

**Solution : Réinstaller le pilote**

```
nvidia-driver-update --force
```

***

#### Si le problème persiste — supprimez complètement le serveur de Clore, changez le token et réajoutez-le.

Cela aide souvent si les configurations internes sont corrompues.

***

<mark style="color:bleu;">**Échec Docker**</mark> <mark style="color:bleu;"></mark><mark style="color:bleu;">presque toujours signifie que</mark> <mark style="color:bleu;"></mark><mark style="color:bleu;">**Clore ne voit pas le GPU**</mark><mark style="color:bleu;">.</mark>\ <mark style="color:bleu;">Dans</mark> <mark style="color:bleu;"></mark><mark style="color:bleu;">**90% des cas**</mark><mark style="color:bleu;">, la cause est soit un service désactivé soit un GPU/risers instable.</mark>\ <mark style="color:bleu;">Corrigez la cause principale, activez les services au démarrage — et votre rig restera en ligne.</mark>


---

# 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/server-offline-on-clore.ai/docker-failure.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.