Einführung

Der Level-Agent ist ein schlanker Hintergrunddienst, der sich mit Ihrem Konto verbindet und Fernüberwachung, Automatisierung und Verwaltung für ein Linux-Gerät ermöglicht. Die Installation erfolgt mit einem einzigen Befehl, der als Root oder mit sudo ausgeführt wird.

⚙️ VORAUSSETZUNGEN

Ein Level-Konto mit der Berechtigung, Geräte hinzuzufügen
Root-Zugriff oder sudo auf dem Zielgerät
Eine unterstützte Linux-Distribution, die systemd ausführt
Erforderliche Pakete: curl, bash, ca-certificates, sudo, dbus (oder eine UUID in /etc/machine-id)

🎬 VIDEO

Linux-Installation

Klicken Sie auf Neues Gerät hinzufügen in der oberen rechten Ecke der Geräteliste Seite. Wählen Sie im Betriebssystem-Auswahlmenü Linux.

Gerätegruppe auswählen (optional)

Wählen Sie eine Gerätegruppe aus, bevor Sie den Installationsbefehl kopieren. Der Installationsschlüssel wird aktualisiert und enthält die Gruppen-ID, sodass das Gerät beim ersten Einchecken in der richtigen Gruppe landet.

Wenn Sie dies überspringen, landet das Gerät in Ohne Gruppe — Sie können es danach verschieben.

Der Installationsschlüssel

Jede Linux-Installationsmethode verwendet einen Installationsschlüssel — ein kurzes Token, das im Modal sichtbar ist und neue Geräte mit Ihrem Level-Konto verknüpft. Es ist eng begrenzt: Falls es offengelegt wird, kann damit weder auf Ihr Konto, bestehende Geräte noch die Level-API zugegriffen werden. Das einzige Risiko besteht darin, dass jemand damit Geräte zu Ihrem Konto hinzufügen könnte.

Wenn Sie glauben, dass Ihr Installationsschlüssel kompromittiert wurde, wenden Sie sich an den Level-Support, um ihn zu rotieren.

ℹ️ HINWEIS: Der Installationsschlüssel spiegelt Ihre Gruppenauswahl in Echtzeit wider. Ohne ausgewählte Gruppe enthält er nur Ihre Kontokennung. Wenn Sie eine Gruppe auswählen, wird die ID der Gruppe angehängt.

Installationsmethoden

Das Modal verfügt über zwei Registerkarten für Linux.

Einzeiliger Befehl

Ein einzeiliger Bash-Befehl, der den Agent herunterlädt und installiert. Dies ist die Standardmethode für die meisten Linux-Bereitstellungen und erkennt die Architektur automatisch.

Wählen Sie im Modal die Einzeiliger Befehl Registerkarte.
Wählen Sie optional eine Gerätegruppe aus.
Kopieren Sie den generierten Befehl.
Öffnen Sie auf dem Zielgerät ein Terminal.
Führen Sie den Befehl aus. Wenn Sie nicht bereits Root sind, enthält der Befehl sudo — Sie werden nach Ihrem Passwort gefragt.

Das Gerät erscheint in Ihrer Geräteliste innerhalb von 5–10 Sekunden nach Abschluss der Installation.

Installationsprogramm

Lädt eine architekturspezifische Binärdatei herunter und installiert sie über die Befehlszeile. Verwenden Sie diese Methode, wenn Sie die Architektur explizit angeben möchten oder einen manuellen Installationsprozess bevorzugen.

Wählen Sie im Modal die Installationsprogramm Registerkarte.
Wählen Sie Ihre Architektur aus dem Dropdown-Menü: x64 oder ARM.
Wählen Sie optional eine Gerätegruppe aus.
Klicken Sie auf Installationsprogramm herunterladen um die Binärdatei herunterzuladen.
Kopieren Sie den im Modal angezeigten Installationsbefehl.
Führen Sie auf dem Zielgerät den kopierten Befehl mit erhöhten Berechtigungen aus.

Der Befehl macht die Binärdatei ausführbar und führt die Installation durch, wobei das Gerät mithilfe des eingebetteten Installationsschlüssels bei Ihrem Konto registriert wird.

Erzwungene Installation (Erweitert)

Wenn eine frühere Level-Installation veraltete Dateien hinterlassen hat, verwenden Sie den forceInstall URL-Parameter, um eine saubere Überschreibung zu erzwingen.

Navigieren Sie zu:

https://app.level.io/devices?forceInstall=true

Dadurch wird LEVEL_FORCE_INSTALL=true zum generierten einzeiligen Befehl.

⚠️ WARNUNG: Die erzwungene Installation überschreibt jede vorhandene Level-Agent-Konfiguration auf dem Gerät. Verwenden Sie dies nur, wenn eine Standardinstallation fehlschlägt oder der Level-Support Sie dazu auffordert.

Systemanforderungen

Unterstützte Distributionen

Distribution	Mindestversion
AlmaLinux	Aktuell stabil
Arch Linux	Aktuell stabil
CentOS	8
Debian	10
Fedora	36
Fedora Silverblue / COSMIC Atomic (rpm-ostree)	Aktuell stabil
Linux Mint	20
Photon OS (VMware)	Aktuell stabil
Raspbian (Raspberry Pi OS)	Aktuell stabil
Red Hat Enterprise Linux (RHEL)	8
Rocky Linux	8
Sangoma Linux	Aktuell stabil
Ubuntu	20.04 LTS

🖥️ PLATTFORMHINWEIS: rpm-ostree-Systeme wie Fedora Silverblue und COSMIC Atomic werden unterstützt. Der Agent schreibt seine systemd-Neustartverzögerung über eine Drop-in-Datei und speichert Desktop-Einträge unter /usr/local/share, sodass keine schreibgeschützten Systempfade beschrieben werden. Ausstehende rpm-ostree-Bereitstellungen werden für Neustart-Prüfungen erkannt.

ℹ️ HINWEIS: Andere Distributionen funktionieren möglicherweise, werden jedoch nicht offiziell unterstützt. Wenn Sie bei einer nicht aufgeführten Distribution auf Probleme stoßen, wenden Sie sich an den Level-Support.

Erforderliche Abhängigkeiten

Die folgenden Pakete müssen auf dem Zielsystem vorhanden sein, bevor die Installation durchgeführt wird:

sudo
systemd (für die Dienstverwaltung)
dbus oder eine UUID in /etc/machine-id
curl
ca-certificates
bash

Die meisten unterstützten Distributionen enthalten diese standardmäßig. Bei minimalen Installationen sollten Sie dies überprüfen, bevor Sie den Level-Installationsbefehl ausführen.

Speicherorte

Pfad	Zweck
`/usr/local/bin/level`	Agent-Binärdatei
`/var/lib/level`	Agent-Daten

Nach der Installation

Das Gerät erscheint in Ihrer Geräteliste innerhalb von 5–10 Sekunden und beginnt innerhalb weniger Minuten mit der Erfassung des Hardware-Inventars.

Wenn das Gerät nicht erscheint, lesen Sie Offline-Fehlerbehebung für weitere Schritte.

Häufig gestellte Fragen

Ist der Installationsschlüssel dasselbe wie ein API-Schlüssel? Nein. Der Installationsschlüssel (aus Neues Gerät hinzufügen) registriert nur Geräte in Ihrem Konto. API-Schlüssel (aus Einstellungen → API-Schlüssel) externe Tools gegenüber der Level-API authentifizieren. Der Agent kann nicht mit einem API-Schlüssel installiert werden — verwenden Sie den Installationsschlüssel aus dem Installations-Modal. Siehe Einstellungen für API-Schlüssel.
Muss ich den Installationsbefehl als Root ausführen? Ja, der Agent benötigt erhöhte Berechtigungen für die Installation. Der einzeilige Befehl enthält sudo automatisch. Führen Sie beim manuellen Installationsprogramm den Befehl mit sudo oder direkt als Root.
Welche Architektur sollte ich auf der Registerkarte „Installationsprogramm" auswählen? Wählen Sie x64 für standardmäßige 64-Bit-Intel/AMD-Systeme und ARM für ARM-basierte Geräte (einschließlich Raspberry Pi). Die einzeilige Befehlsmethode erkennt die Architektur automatisch.
Kann ich Level auf Fedora Silverblue oder COSMIC Atomic installieren? Ja. Diese rpm-ostree-Systeme sind in der Unterstützungstabelle aufgeführt. Verwenden Sie das native Installationsprogramm — der Agent beschreibt keine schreibgeschützten Systempfade. Andere unveränderliche Distributionen funktionieren möglicherweise, wenn sie die Abhängigkeitsanforderungen erfüllen, werden jedoch nicht offiziell getestet.
Meine Linux-Distribution ist nicht auf der Unterstützungsliste — funktioniert Level trotzdem? Möglicherweise. Level unterstützt die meisten modernen Distributionen, die systemd ausführen. Wenn Ihre Distribution die Abhängigkeitsanforderungen erfüllt, funktioniert sie möglicherweise einwandfrei — wenden Sie sich an den Level-Support, wenn Sie auf Probleme stoßen.
Das Gerät wurde installiert, erscheint aber nicht in Level — was ist falsch? Warten Sie 10–15 Sekunden und aktualisieren Sie die Seite. Wenn das Gerät immer noch nicht erscheint, überprüfen Sie, ob systemd ausgeführt wird und alle erforderlichen Abhängigkeiten (curl, dbus, usw.) während der Installation vorhanden waren. Siehe Offline-Fehlerbehebung für weitere Schritte.
Was ist zu tun, wenn mein Installationsschlüssel kompromittiert wurde? Der Installationsschlüssel kann nicht auf Ihr Konto, bestehende Geräte oder die Level-API zugreifen. Das einzige Risiko besteht darin, dass jemand Geräte zu Ihrem Konto hinzufügt. Wenden Sie sich bei Bedarf an den Level-Support, um den Schlüssel zu rotieren.
Kann ich den Agent gleichzeitig auf vielen Linux-Geräten bereitstellen? Ja — verwenden Sie den einzeiligen Befehl mit Ihren vorhandenen Tools (Ansible, Puppet, Chef, Bash über SSH usw.).
Wer kann Geräte zu Level hinzufügen? Jeder Techniker mit der Berechtigung, die Zielgerätegruppe zu verwalten, oder jeder Techniker, wenn die Bereitstellung für „Ohne Gruppe" erfolgt. Überprüfen Sie Arbeitsbereich → Berechtigungen wenn die Neues Gerät hinzufügen Schaltfläche.

Verwandte Artikel