> 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-ubuntu.md).

# Installation unter Ubuntu

## 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.

## Empfohlenes Betriebssystem & Treiber

### Betriebssystem

* **Ubuntu 22.04 LTS** — empfohlen, beste GPU-Treiberkompatibilität
* **Ubuntu 24.04 LTS** — unterstützt, aber Kernel 6.16+ können bei älteren Treiberzweigen (R550 und älter) Probleme verursachen

### NVIDIA-Treiber

| Zweig       | Version    | CUDA-Unterstützung | Empfohlen für                             |
| ----------- | ---------- | ------------------ | ----------------------------------------- |
| R580 (LTSB) | 580.126.18 | Bis zu CUDA 12.8   | Die meisten GPUs, langfristige Stabilität |
| R590        | 590.48.01  | Bis zu CUDA 13.1   | RTX-50-Serie, neueste Funktionen          |

Installieren Sie den empfohlenen Treiber:

```bash
sudo apt install nvidia-driver-580
```

Oder für die RTX-50-Serie:

```bash
sudo apt install nvidia-driver-590
```

### CUDA Toolkit (für ML-/KI-Workloads)

Mieter, die ML-Workloads ausführen, erwarten CUDA. Empfohlene Versionen:

| CUDA-Version | Mindesttreiber | Status                                  |
| ------------ | -------------- | --------------------------------------- |
| CUDA 12.8    | R570+          | Stabil, breite Ökosystemunterstützung   |
| CUDA 13.1    | R590+          | Neueste, für die RTX-50-Serie optimiert |

Die meisten Docker-Images enthalten ihre eigene CUDA-Runtime, daher müssen Hosts das CUDA Toolkit nicht immer systemweit installieren. Kompatible Treiber sind jedoch unerlässlich.

## 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. **Updates in Reihenfolge ausführen:**

```bash
sudo apt update && sudo apt upgrade -y
```

### 4. Abhängigkeiten installieren:

```
sudo apt install -y curl git gnupg lsb-release
```

### 5. Wechseln Sie in den Superuser-Modus:

```bash
sudo -i
```

### 6. **Die Software installieren:**

```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)
```

### 7. **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.

### 8. **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.

```
sudo 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-ubuntu.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.