# 🛠️ Guide: Conveyor Installation

Dieses Dokument beschreibt die Installation von **Hydraulic Conveyor** auf verschiedenen Linux-Distributionen (Ubuntu
26.04 und Fedora 44).

---

## 1. Ubuntu 26.04 (Debian-basiert)

Der am einfachsten Weg für Ubuntu ist der direkte Download des `.deb`-Pakets. Dieses konfiguriert bei der Installation
automatisch das APT-Repository für zukünftige Updates.

### Installation via .deb (Empfohlen)

```bash
# Aktuelles Paket herunterladen (Beispiel v12.0 - bitte Version ggf. anpassen)
VERSION="12.0"
curl -L https://downloads.hydraulic.dev/conveyor/conveyor_${VERSION}_amd64.deb -o conveyor.deb

# Installieren (konfiguriert auch das Repo automatisch)
sudo apt update
sudo apt install ./conveyor.deb
```

---

## 2. Fedora 44 (RPM-basiert)

Für Fedora wird die Installation via Tarball empfohlen, da Conveyor als autarkes Binary geliefert wird.

### Installation via Tarball (Systemweit)

Dies ist der zuverlässigste Weg für Fedora:

```bash
# Version definieren (Beispiel v12.0, bitte aktuelle Version prüfen)
VERSION="12.0"
curl -L https://downloads.hydraulic.dev/conveyor/conveyor-${VERSION}-linux-amd64.tar.gz -o conveyor.tar.gz

# Entpacken nach /opt
sudo tar -xzf conveyor.tar.gz -C /opt/
sudo ln -s /opt/conveyor-${VERSION}/bin/conveyor /usr/local/bin/conveyor

# Test
conveyor --version
```

### Installation via RPM (Falls verfügbar)

Prüfen Sie auf der Hydraulic Website, ob mittlerweile ein natives RPM-Repository existiert. Falls ja:

```bash
sudo dnf config-manager --add-repo https://conveyor.hydraulic.dev/rpm/conveyor.repo
sudo dnf install conveyor
```

---

## 3. Post-Installation & Verifikation

Nach der Installation sollten Sie den Pfad und die Version prüfen:

```bash
conveyor --version
```

### Root-Key Initialisierung

Beim ersten Ausführen von `conveyor` wird ein Root-Key generiert. **Sichern Sie diesen unbedingt!**

```bash
conveyor make site
```

*Folgen Sie den Anweisungen im Terminal zur Sicherung des Root-Keys.*

---

## 4. Troubleshooting

### Fehlende Bibliotheken (Fedora)

Falls Conveyor native Hilfe benötigt (z.B. für Icons oder Kompression):

```bash
sudo dnf install libX11 libXext libXrender
```

### Berechtigungen

Stellen Sie sicher, dass Ihr Benutzer in der Gruppe `docker` ist, falls Sie Conveyor innerhalb von Containern nutzen
oder Docker-basierte Inputs verwenden (für dieses Projekt primär lokal relevant).