> 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 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 (empfohlen werden mindestens 30 GB freier Speicher auf der Systempartition); aus Zuverlässigkeitsgründen wird empfohlen, eine SSD anstelle eines Flash-Laufwerks 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, aber für eine effizientere Leistung sollten Sie eine CPU wie den i7-6700 in Betracht ziehen.

Bevor Sie fortfahren, wird dringend empfohlen, jegliches Overclocking zu deaktivieren, einschließlich des Power Limit (PL), und die GPUs auf Werkseinstellungen zurückzusetzen. Testen Sie anschließend die Stabilität des Systems unter Last, indem Sie zum Beispiel 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 arbeitet und die Temperaturen in einem sicheren Bereich liegen, fahren Sie mit dem nächsten Schritt in der Anleitung fort. Wenn die Temperaturen zu hoch sind oder Fehler auftreten, beheben Sie diese Probleme zunächst – 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 mit älteren Treiberzweigen (R550 und älter) Probleme haben

{% hint style="warning" %}
Das Installationsprogramm benötigt einen **x86\_64** Rechner mit **Ubuntu 22.04 oder neuer** (oder HiveOS — siehe [Software installieren](/clore.ai/clore.ai-eng-de/fur-hosts/installing-clore-hosting/installing-clore-hosting-software.md)). Ubuntu 18.04 und 20.04 werden nicht mehr unterstützt.
{% endhint %}

### NVIDIA-Treiber

Das Installationsprogramm **nicht** installiert oder aktualisiert keine GPU-Treiber — bevor Sie es ausführen, muss ein funktionierender NVIDIA-Treiber installiert sein (`nvidia-smi` muss funktionieren).

| Zweig       | Version    | CUDA-Unterstützung | Empfohlen für                             |
| ----------- | ---------- | ------------------ | ----------------------------------------- |
| R580 (LTSB) | 580.126.18 | Bis CUDA 12.8      | Die meisten GPUs, langfristige Stabilität |
| R590        | 590.48.01  | Bis 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/AI-Workloads)

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

| CUDA-Version | Min. Treiber | Status                                    |
| ------------ | ------------ | ----------------------------------------- |
| CUDA 12.8    | R570+        | Stabil, breite Unterstützung im Ökosystem |
| CUDA 13.1    | R590+        | Neueste, für die RTX-50-Serie optimiert   |

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

## Den Server hinzufügen

Alles wird durch einen einzigen Installationsbefehl gesteuert, den das Dashboard für Sie generiert.

### 1. Server auf der Website erstellen

Gehen Sie zu [clore.ai](https://clore.ai/), registrieren Sie sich oder melden Sie sich an, öffnen Sie [Meine Server](https://clore.ai/my-servers) und klicken Sie auf **Server hinzufügen**. Es sind zwei Wege verfügbar:

* **Schnell** — das Dashboard zeigt einen sofort kopierbaren Befehl an, der den Hosting-Agenten installiert **und** den Rechner in einem Schritt mit Ihrem Konto verknüpft. Der Server erscheint anschließend automatisch unter Meine Server mit Standard-Einstellungen (maximale Mietdauer 300 Stunden, USD-Autopreis bei 5 $ pro Server und Tag für On-Demand und Spot), die Sie danach im Dashboard anpassen können.
* **Erweitert** — Sie benennen den Server zuerst, er erscheint unter Meine Server als wartend auf Installation, und die Serverseite zeigt die Installations- und Registrierungsbefehle dafür an (einschließlich einer kombinierten Einzeile mit dem Token Ihres Servers).

Der **Massen** Abschnitt des gleichen Modals behandelt das Hochfahren ganzer Flotten — siehe [Clore Fleet (Massen-Onboarding)](/clore.ai/clore.ai-eng-de/fur-hosts/advanced/clore-fleet-mass-onboarding.md).

### 2. Installationskanal auswählen

Die generierten Befehle gibt es in drei Kanälen:

| Kanal      | Was es ist                                                                                                                |
| ---------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Stabil** | Empfohlen — gründlich getestete Versionen, werden seltener aktualisiert                                                   |
| **Beta**   | Die neuesten Updates und Funktionen, bevor sie Stable erreichen — möglicherweise weniger zuverlässig                      |
| **Legacy** | Installationsprogramm der vorherigen Generation — eine Fallback-Option, falls Stable auf Ihrem Rechner nicht funktioniert |

Die Befehle pro Kanal:

**Stable (empfohlen):**

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

**Beta:**

```bash
bash <(curl -s https://gitlab.com/cloreai-public/hosting-agent-installer/-/raw/dev/install.sh) --channel beta
```

**Legacy:**

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

Sie können einen laufenden Server später auf der Serverseite zwischen Stable- und Beta-Updates umstellen (erfordert einen aktuellen Hosting-Agenten; nicht möglich, während der Server vermietet ist).

### 3. Installationsbefehl als Root ausführen

```bash
sudo -i
```

Fügen Sie dann den im Dashboard kopierten Befehl ein. Wenn Sie den erweiterten Weg verwendet haben, hängen Sie das auf der Serverseite angezeigte Token an, um in einem Schritt zu installieren und zu registrieren:

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

Wenn Sie den reinen Installationsbefehl ohne Token ausgeführt haben, registrieren Sie den Rechner anschließend mit:

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

Das Installationsprogramm prüft seine Voraussetzungen im Voraus und teilt Ihnen mit, was fehlt. Es benötigt ausgehenden Zugriff auf die Docker- und NVIDIA-Paketquellen, GitHub, GitLab, Docker Hub und `api.clore.ai` — siehe [Netzwerkanforderungen](/clore.ai/clore.ai-eng-de/fur-hosts/installing-clore-hosting/network-requirements.md).

### 4. Abschließen

Starten Sie das Rig neu, warten Sie einen Moment und aktualisieren Sie die Seite Meine Server. Wenn alles korrekt eingerichtet wurde, wird der Server als online angezeigt.

```bash
Neustart
```

## So deaktivieren Sie alle installierten Dienste

Wenn Sie alles zuvor Installierte deaktivieren müssen:

1. Dienste deaktivieren:

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

   ```bash
   Neustart
   ```

## So aktivieren Sie Dienste erneut

Um die Dienste erneut zu aktivieren:

1. Dienste aktivieren:

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

   ```bash
   Neustart
   ```

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