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

# Installation auf HiveOS

Diese Seite behandelt die Installation auf **HiveOS**. Für einen Standard-Ubuntu-Server siehe [Installation unter Ubuntu](/clore.ai/clore.ai-eng-de/fur-hosts/installing-clore-hosting/installing-clore-hosting-ubuntu.md) — der Installationsbefehl ist derselbe; nur die OS-Vorbereitung unterscheidet sich.

## Serveranforderungen

Der Server (oder das Rig – diese Begriffe sind in diesem Zusammenhang nahezu austauschbar) muss mit NVIDIA-GPUs ausgestattet sein, da AMD derzeit nicht unterstützt wird. Der erforderliche minimale Speicherplatz beträgt 32 GB (empfohlen werden mindestens 30 GB freier Speicher auf der Systempartition); aus Gründen der Zuverlässigkeit 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 Overclocking zu deaktivieren, einschließlich des Power Limit (PL), und die GPUs auf Werkseinstellungen zurückzusetzen. Führen Sie anschließend einen Stresstest durch, um die Stabilität des Systems zu prüfen, indem Sie beispielsweise 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 der Anleitung fort. Wenn die Temperaturen zu hoch sind oder Fehler auftreten, beheben Sie diese Probleme zuerst – zum Beispiel durch bessere Kühlung oder Fehlerbehebung – 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 CUDA 12.8      | Für die meisten GPUs — stabiler Langzeitsupport bis Aug. 2028 |
| **R590**        | 590.48.01  | Bis 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:** Verwenden Sie nicht `nvidia-driver-update --force` ohne eine Version anzugeben — es könnte einen älteren Standardtreiber installieren, der moderne CUDA-Workloads nicht unterstützt.

Der Installer selbst **nicht** installiert oder aktualisiert keine GPU-Treiber — vor dem Ausführen muss ein funktionierender NVIDIA-Treiber installiert sein (`nvidia-smi` muss funktionieren).

### Kompatibilität des CUDA Toolkit

Die meisten Mieter verwenden Docker-Images, die ihre eigene CUDA-Laufzeitumgebung enthalten, sodass Hosts das CUDA Toolkit normalerweise nicht manuell installieren müssen. Allerdings **muss der NVIDIA-Treiber des Hosts die CUDA-Version unterstützen, die für die Workload des Mieters erforderlich ist.**

| CUDA-Version | Mindesttreiber | Status                                          |
| ------------ | -------------- | ----------------------------------------------- |
| CUDA 12.4    | R550+          | Weit verbreitet im ML-Ökosystem                 |
| CUDA 12.8    | R570+          | Neuester stabiler 12.x-Zweig                    |
| CUDA 13.1    | R590+          | Neueste Version, 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 vollständige CUDA-13.x-Unterstützung.

## Das Rig vorbereiten (HiveOS)

### 1. Öffnen Sie die Shell des Rigs in HiveOS

Wählen Sie das Rig im HiveOS-Dashboard aus und öffnen Sie **Remote Access → Hive Shell Start** (oder verbinden Sie sich per SSH).

### 2. HiveOS aktualisieren

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

#### Wenn in HiveOS Speicherplatzprobleme 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
  ```

### 3. Führen Sie die Updates nacheinander aus

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

### 4. Den Treiber aktualisieren

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

Für GPUs der RTX-50-Serie verwenden Sie Version `590.48.01` oder neuer.

### 5. Das Rig neu starten

```bash
reboot
```

## Den Hosting-Agenten installieren

Die Installation erfolgt mit einem einzigen Befehl, der Ihnen vom Dashboard generiert wird. Der Installer erkennt HiveOS automatisch — derselbe Befehl funktioniert sowohl auf Ubuntu- als auch auf HiveOS-Rigs.

### 1. Erstellen Sie den Server auf der Website

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**:

* **Schnell** — ein Befehl, der den Hosting-Agenten installiert **und** das Gerät in einem Schritt mit Standard-Einstellungen in Ihrem Konto registriert (maximale Mietdauer 300 Stunden, USD-Autopreis von 5 $ pro Server und Tag für On-Demand und Spot), die Sie anschließend über das Dashboard anpassen können.
* **Erweitert** — benennen Sie den Server zuerst und kopieren Sie dann von der Serverseite seine Installations- und Registrierungsbefehle (einschließlich einer kombinierten Einzeile mit dem Token des Servers).

Um viele Rigs gleichzeitig einzurichten, verwenden Sie stattdessen den **Massen** Bereich des Modals — HiveOS-Fleets werden dort über ein Flight Sheet eingebunden; siehe [Clore Fleet (Massen-Onboarding)](/clore.ai/clore.ai-eng-de/fur-hosts/advanced/clore-fleet-mass-onboarding.md). Um ein einzelnes Rig über Ihr verknüpftes HiveOS-Konto einzubinden, siehe [HiveOS-Integration](/clore.ai/clore.ai-eng-de/fur-hosts/advanced/hiveos-integration.md).

### 2. Wählen Sie einen Installer-Kanal

| Kanal      | Was es ist                                                                                                   |
| ---------- | ------------------------------------------------------------------------------------------------------------ |
| **Stable** | Empfohlen — gründlich getestete Versionen, werden seltener aktualisiert                                      |
| **Beta**   | Neueste Updates und Funktionen, bevor sie Stable erreichen — möglicherweise weniger zuverlässig              |
| **Legacy** | Installer der vorherigen Generation — eine Ausweichoption, wenn Stable auf Ihrer Maschine nicht funktioniert |

**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 über seine Serverseite zwischen Stable- und Beta-Updates umschalten (erfordert einen aktuellen Hosting-Agenten; nicht möglich, während der Server vermietet ist).

### 3. Führen Sie den Installationsbefehl als root aus

```bash
sudo -i
```

(In der Hive Shell sind Sie normalerweise bereits root.)

Fügen Sie dann den aus dem Dashboard kopierten Befehl ein. Wenn Sie den Erweitert-Pfad 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 das Gerät anschließend mit:

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

Der Installer prüft seine Voraussetzungen im Voraus und teilt Ihnen mit, was fehlt. Er 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
reboot
```

## So deaktivieren Sie alle installierten Dienste

Wenn Sie alles zuvor Installierte deaktivieren müssen:

1. Deaktivieren Sie die Dienste:

   ```bash
   systemctl disable clore-hosting.service
   systemctl disable docker.service
   systemctl disable docker.socket
   ```
2. Starten Sie das System neu:

   ```bash
   reboot
   ```

## So aktivieren Sie die Dienste erneut

Um die Dienste erneut zu aktivieren:

1. Aktivieren Sie die Dienste:

   ```bash
   systemctl enable clore-hosting.service
   systemctl enable docker.service
   systemctl enable docker.socket
   ```
2. Starten Sie das System neu:

   ```bash
   reboot
   ```

## Den zuvor installierten Token entfernen

Um den 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.
