> 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 de Docker* et le maintient hors ligne, même si HiveOS est en cours d'exécution.

**Symptômes**

* Une icône « Échec de Docker » s’affiche dans le panneau Clore.
* Dans la **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 de 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 réapparaît 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 figée des dépendances (par exemple aiofiles, docker, etc.).

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

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

***

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

Version recommandée : **27.5.1**\
Les plantages sont fréquents 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 : les services requis ne sont pas activés au démarrage

Après le redémarrage, le système ne lance pas Docker ni 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 l’utiliser → cela entraîne un échec de Docker.

**Solution : réinstaller le pilote**

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

***

#### Si le problème persiste — supprimez complètement le serveur de Clore, changez le jeton et ajoutez-le à nouveau.

Cela aide souvent si les configurations internes sont corrompues.

***

<mark style="color:bleu;">**Échec de Docker**</mark> <mark style="color:bleu;">signifie presque toujours que</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;">**90 % des cas**</mark><mark style="color:bleu;">, la cause est soit un service désactivé, soit un GPU/riser instable.</mark>\\\ <mark style="color:bleu;">Corrigez le problème racine, 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.