Docker Failure
Problem Clore.ai marks the rig as Docker Failure and keeps it offline, even though HiveOS is running.
Symptoms
A “Docker Failure” icon is shown in the Clore panel.
In the My Servers section, GPUs are displayed as 0x Unknown or the GPU count keeps changing.
Cause 1: Unstable GPU or Riser
Clore cannot initialize a GPU if it's disconnected or unstable. Even if HiveOS sees the GPU, Clore can’t use it → Docker Failure.
Solution: Restart and Check Hardware
Check the GPU or riser, make sure everything is securely connected.
Reboot the rig:
reboot
If the error returns after reboot, the issue is likely with the GPU, motherboard, or risers.
Cause 2: Corrupted Python Environment (Miniconda)
Clore hangs on startup if the directory /opt/clore-hosting/miniconda-env
is corrupted.
Solution: Remove the environment and restart
sudo systemctl stop clore-hosting.service
sudo rm -rf /opt/clore-hosting/miniconda-env
sudo systemctl start clore-hosting.service
Cause 3: Dependency installation is stuck
If Clore doesn't start, it may be due to a frozen installation of dependencies (e.g. aiofiles, docker, etc.).
Solution: Reinstall dependencies
sudo /opt/clore-hosting/clore.sh --reinstall
Cause 4: Unstable Docker version installed (e.g., 28.*)
Recommended version: 27.5.1 Crashes are common with Docker 28+.
Solution: Downgrade Docker
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: Required services are not enabled on startup
After reboot, the system doesn't launch Docker and Clore Hosting → server goes offline.
Solution: Enable services on startup
sudo systemctl enable clore-hosting.service
sudo systemctl enable docker.service
sudo systemctl enable docker.socket
Cause 6: Driver doesn't detect GPUs (nvidia-smi → No devices found
)
nvidia-smi → No devices found
)If HiveOS doesn't detect the GPU, Clore can't work with it → results in Docker Failure.
Solution: Reinstall the driver
nvidia-driver-update --force
If the issue persists — fully remove the server from Clore, change the token, and re-add it.
This often helps if internal configs are broken.
Docker Failure almost always means that Clore doesn't see the GPU. In 90% of cases, the cause is either a disabled service or an unstable GPU/risers. Fix the root issue, enable services on startup — and your rig will stay online.
Last updated