> 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-de/fur-hosts/installing-clore-hosting/installing-clore-hosting-software.md).

# Software installieren

## Serveranforderungen

Der Server (oder das Rig – diese Begriffe sind in diesem Kontext nahezu austauschbar) muss mit NVIDIA-GPUs ausgestattet sein, da AMD derzeit nicht unterstützt wird. Der erforderliche Mindestfestplattenspeicher beträgt 32 GB; aus Zuverlässigkeitsgründen wird empfohlen, eine SSD statt eines USB-Sticks zu verwenden. Es sind mindestens 8 GB RAM erforderlich, 16 GB sorgen jedoch für mehr Stabilität. Was die CPU betrifft, kann das System mit einem Celeron auf einem 1151-Sockel arbeiten, für eine effizientere Leistung sollten Sie jedoch eine CPU wie den i7-6700 in Betracht ziehen.

Bevor Sie fortfahren, wird dringend empfohlen, jegliches Übertakten zu deaktivieren, einschließlich des Power Limit (PL), und die GPUs auf die Werkseinstellungen zurückzusetzen. Anschließend sollten Sie das System auf Stabilität unter Last testen, zum Beispiel indem Sie die GPUs mit dem KawPow-Algorithmus testen und die CPU auslasten. Überwachen Sie die Temperaturen und stellen Sie sicher, dass alles stabil läuft.

Wenn das System stabil läuft und die Temperaturen in einem sicheren Bereich liegen, fahren Sie mit dem nächsten Schritt in den Anweisungen fort. Wenn die Temperaturen zu hoch sind oder Fehler auftreten, beheben Sie diese Probleme zuerst – zum Beispiel durch bessere Kühlung oder Fehlersuche – und stellen Sie einen stabilen Betrieb sicher, bevor Sie fortfahren.

## Empfohlene Treiber & CUDA (HiveOS)

HiveOS verfügt über eine eigene Treiberverwaltung über den `nvidia-driver-update` Befehl. Für die beste Kompatibilität mit Clore.ai-Workloads (insbesondere ML/AI) verwenden Sie die folgenden empfohlenen Versionen:

### NVIDIA-Treiber

| Zweig           | Version    | CUDA-Unterstützung | Empfohlen für                                                  |
| --------------- | ---------- | ------------------ | -------------------------------------------------------------- |
| **R580 (LTSB)** | 580.126.18 | Bis zu CUDA 12.8   | Die meisten GPUs — stabile Langzeitunterstützung bis Aug. 2028 |
| **R590**        | 590.48.01  | Bis zu CUDA 13.1   | RTX-50-Serie (5090/5080), neueste Funktionen                   |

Um eine bestimmte Version in HiveOS zu installieren:

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

Für GPUs der RTX-50-Serie:

```bash
nvidia-driver-update 590.48.01 --force
```

> **Wichtig:** Nicht verwenden `nvidia-driver-update --force` ohne eine Version anzugeben — es könnte ein älterer Standardtreiber installiert werden, der moderne CUDA-Workloads nicht unterstützt.

### Kompatibilität des CUDA Toolkit

Die meisten Auftraggeber verwenden Docker-Images, die ihre eigene CUDA-Laufzeitumgebung enthalten, daher müssen Hosts das CUDA Toolkit in der Regel nicht manuell installieren. Allerdings **muss der NVIDIA-Treiber des Hosts die CUDA-Version unterstützen, die für den Workload des Auftraggebers erforderlich ist.**

| CUDA-Version | Mindestreiber | Status                                  |
| ------------ | ------------- | --------------------------------------- |
| CUDA 12.4    | R550+         | Weit verbreitet im ML-Ökosystem         |
| CUDA 12.8    | R570+         | Neuester stabiler 12.x-Zweig            |
| CUDA 13.1    | R590+         | Neueste, optimiert für die RTX-50-Serie |

**Empfehlung:** Installieren Sie R580 LTSB (580.126.18) für breite Kompatibilität mit CUDA-12.x-Workloads. Wenn Sie GPUs der RTX-50-Serie hosten, verwenden Sie R590 (590.48.01) für volle CUDA-13.x-Unterstützung.

## Registrieren und Hinzufügen des Servers

### 1. Gehen Sie zur [Website](http://clore.ai/), registrieren Sie sich, melden Sie sich an und navigieren Sie zum Marktplatz:

<figure><img src="https://img1.teletype.in/files/0e/86/0e86de72-544d-48d8-8d82-cf120e516a81.png" alt=""><figcaption></figcaption></figure>

### 2. **Server hinzufügen:** Es gibt zwei Möglichkeiten, einen Server hinzuzufügen:

**Methode 1:** Gehen Sie zum Bereich „My Servers“ und klicken Sie auf die Schaltfläche „+Add Server“. Geben Sie den Namen des Servers ein und klicken Sie auf „Next“.

<figure><img src="https://img4.teletype.in/files/f7/8e/f78e0a46-06fa-4a5d-b429-f21b78eafb6c.png" alt=""><figcaption></figcaption></figure>

Nach dem Hinzufügen wird der Server mit einem roten Kreis markiert, was bedeutet, dass er inaktiv ist. Wir werden ihn später aktivieren, aber klicken Sie vorerst auf den erstellten Server, um einen Schlüssel zu erhalten – Sie benötigen ihn später.

<figure><img src="https://img4.teletype.in/files/36/ae/36aeeab8-98e0-4fea-81e9-d731d5211df2.png" alt=""><figcaption></figcaption></figure>

### 3. HiveOS-Einrichtung:

Wählen Sie das Rig aus und öffnen Sie die Shell. Für diejenigen, die HiveOS selten verwenden, wurden unten zur besseren Übersicht Bilder hinzugefügt.

<figure><img src="https://img1.teletype.in/files/45/06/4506318a-02cf-4de5-b5c8-bcf44df412ea.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://img3.teletype.in/files/e7/8e/e78e68e8-04da-4f84-89ab-546426d5f761.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://telegra.ph/file/49b76dd27191faca74a44.png" alt=""><figcaption></figcaption></figure>

### 4. **HiveOS-Update:** Führen Sie den Befehl aus:

```bash
hive-replace -y --stable
```

#### **Wenn Probleme mit dem Speicherplatz in HiveOS auftreten:** Wenn nach der Installation oder Aktualisierung weniger freier Speicherplatz auf der Festplatte vorhanden ist als erwartet (z. B. nur 20 GB frei auf einer 512-GB-Festplatte), führen Sie Folgendes aus:

* **Für M.2:**

  ```bash
  growpart /dev/nvme0n1 4
  resize2fs /dev/nvme0n1p4
  ```
* **Für SATA:**

  ```bash
  growpart /dev/sda 4
  resize2fs /dev/sda4
  ```

### 5. **Updates in Reihenfolge ausführen:**

```bash
selfupgrade --force
apt update
apt upgrade
apt autoremove
```

### 6. **Erforderliche Treiber aktualisieren:**

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

> **Tipp:** Um eine bestimmte empfohlene Treiberversion zu installieren, verwenden Sie:
>
> ```bash
> nvidia-driver-update 580.126.18 --force
> ```
>
> Für GPUs der RTX-50-Serie verwenden Sie Version `590.48.01` oder neuer.

### 7. **Das Rig neu starten:**

```bash
reboot
```

### 8. **In den Superuser-Modus wechseln:**

```bash
sudo -i
```

### 9. **Die Software installieren:**

> **Tipp: Installationskanäle.** Die Onboarding-Seite „My Servers“ generiert sofort kopierbare Einzeilen-Befehle zum Installieren und Registrieren mit der Auswahl von **Stable** oder **Beta** Kanal (plus einer Legacy-Fallback-Option). Wenn Sie diese generierten Befehle verwenden, können Sie die manuellen Installations- und Aktivierungsschritte unten überspringen.

```bash
bash <(curl -s https://gitlab.com/cloreai-public/hosting/-/raw/main/install.sh)
```

Wenn das System meldet, dass `git` fehlt, installieren Sie es mit:

```bash
apt install -y git
```

Wiederholen Sie anschließend die Installation.

Wenn ein `gpg` Fehler auftritt, verwenden Sie:

<figure><img src="https://telegra.ph/file/e2ef8c5760193ad523e20.png" alt=""><figcaption></figcaption></figure>

```bash
apt install gpg -y --allow-downgrades
```

<figure><img src="https://img3.teletype.in/files/66/1c/661c9073-cc8e-4734-aa85-cff08902d4d6.png" alt=""><figcaption></figcaption></figure>

Führen Sie anschließend die Installation erneut aus.

```
bash <(curl -s https://gitlab.com/cloreai-public/hosting/-/raw/main/install.sh)
```

### 10. **Server aktivieren:**

```bash
/opt/clore-hosting/clore.sh --init-token <token>
```

Ersetzen Sie `<token>` durch den zuvor erhaltenen Schlüssel.

Wenn ein Fehler auf einen fehlenden Ordner oder eine fehlende Datei hinweist, wurde die Installation wahrscheinlich nicht korrekt abgeschlossen, und der `clore-hosting` Ordner wurde nicht erstellt. In diesem Fall wiederholen Sie die Installation.

### 11. **Neustart abschließen:**

Starten Sie das Rig neu, warten Sie einen Moment und aktualisieren Sie die Marktplatzseite. Wenn alles korrekt eingerichtet wurde, wird der Server mit einem grünen Kreis markiert.

```
reboot
```

<figure><img src="https://img2.teletype.in/files/98/9c/989c1cbd-2670-4568-b784-020af71451be.png" alt=""><figcaption></figcaption></figure>

## So deaktivieren Sie alle installierten Dienste

Wenn Sie alles zuvor Installierte deaktivieren müssen:

1. Die Dienste deaktivieren:

   ```bash
   systemctl disable clore-hosting.service
   systemctl disable docker.service
   systemctl disable docker.socket
   ```
2. Das System neu starten:

   ```bash
   reboot
   ```

## So aktivieren Sie Dienste erneut

Um die Dienste erneut zu aktivieren:

1. Die Dienste aktivieren:

   ```bash
   systemctl enable clore-hosting.service
   systemctl enable docker.service
   systemctl enable docker.socket
   ```
2. Das System neu starten:

   ```bash
   reboot
   ```

## Das zuvor installierte Token entfernen

Um das Token zu löschen, verwenden Sie den Befehl:

```bash
/opt/clore-hosting/clore.sh --reset
```

Die Datei mit dem Token befindet sich unter:

```
/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-de/fur-hosts/installing-clore-hosting/installing-clore-hosting-software.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.