# Installation auf 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; aus Zuverlässigkeitsgründen wird empfohlen, eine SSD statt eines Flash-Laufwerks zu verwenden. Mindestens 8 GB RAM werden benötigt, aber 16 GB bieten mehr Stabilität. Was die CPU betrifft, kann das System mit einem Celeron auf einem 1151-Sockel arbeiten, für effizientere Leistung sollte man jedoch eine CPU wie den i7-6700 in Betracht ziehen.

Bevor Sie fortfahren, wird dringend empfohlen, jegliches Overclocking, einschließlich der Power Limit (PL)-Einstellungen, zu deaktivieren und die GPUs auf die Werkseinstellungen zurückzusetzen. Testen Sie anschließend die Stabilität des Systems durch einen Stresstest, zum Beispiel indem Sie die GPUs mit dem kawpow-Algorithmus prüfen und die CPU belasten. Überwachen Sie die Temperaturen und stellen Sie sicher, dass alles stabil läuft.

Wenn das System stabil läuft und die Temperaturen im 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 – beispielsweise durch Verbesserung der Kühlung oder Fehlersuche – und stellen Sie einen stabilen Betrieb sicher, bevor Sie weitergehen.

## Empfohlenes OS & Treiber

### Betriebssystem

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

### 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/AI-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 RTX-50-Serie optimiert   |

Die meisten Docker-Images enthalten ihre eigene CUDA-Laufzeit, sodass Hosts das CUDA-Toolkit nicht immer systemweit installieren müssen. Allerdings sind kompatible Treiber unerlässlich.

## Registrierung 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. **Hinzufügen eines Servers:** Es gibt zwei Möglichkeiten, einen Server hinzuzufügen:

**Methode 1:** Gehen Sie zum Bereich „Meine Server“ und klicken Sie auf die Schaltfläche „+Server hinzufügen“. Geben Sie den Namen des Servers ein und klicken Sie auf „Weiter“.

<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; klicken Sie vorerst auf den erstellten Server, um einen Schlüssel zu erhalten – Sie werden ihn später benötigen.

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

### 3. **Führen Sie Updates in der Reihenfolge aus:**

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

### 4. Installieren Sie Abhängigkeiten:

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

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

```bash
sudo -i
```

### 6. **Installieren Sie die Software:**

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

Versuchen Sie anschließend die Installation erneut.

Wenn Sie auf einen `gpg` Fehler stoßen, 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. **Aktivieren Sie den Server:**

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

## Wie man alle installierten Dienste deaktiviert

Wenn Sie alles vorher 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
   ```

## Wie man Dienste wieder aktiviert

Um die Dienste wieder 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
   ```

## Entfernen des zuvor installierten Tokens

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

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

Die Datei, die das Token enthält, befindet sich unter:

```
/opt/clore-hosting/client/auth
```