Files
meldestelle/docs/02_Guides/Conveyor-Installation-Guide.md

2.4 KiB

🛠️ 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)

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

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

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:

conveyor --version

Root-Key Initialisierung

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

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

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