> 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 Docker

**Problème**\
Clore.ai marque le rig comme *Échec Docker* et le maintient hors ligne, même si HiveOS est en cours d'exécution.

**Symptômes**

* Une icône « Échec Docker » s’affiche dans le panneau Clore.
* Dans le **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 détecte 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 bien connecté.
2. Redémarrez le rig :

```
redémarrer
```

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 figée des dépendances (par ex. 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 Docker.

**Solution : réinstaller le pilote**

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

***

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

Cela aide souvent si les configurations internes sont corrompues.

***

<mark style="color:bleu;">**Échec 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 à la source, 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.