Introduction

L'agent Level est un service de fond léger qui se synchronise avec votre compte et met à disposition la surveillance, l'automatisation et la gestion à distance pour un appareil Linux. L'installation est une seule commande exécutée en tant que root ou avec sudo.

⚙️ PRÉREQUIS

Un compte Level avec la permission d'ajouter des appareils
Accès root ou sudo sur l'appareil cible
Une distribution Linux prise en charge exécutant systemd
Packages requis: curl, bash, ca-certificates , sudo, dbus (or a UUID in /etc/machine-id)

🎬 VIDEO

Installation Linux

Click Ajouter un nouvel appareil dans le coin supérieur droit du Liste des appareilspage. Dans le sélecteur du système d'exploitation, choisissez Linux .

Sélection d'un groupe d'appareils (facultatif)

Sélectionnez un groupe d'appareils avant de copier votre commande d'installation. La clé d'installation est mise à jour pour inclure l'ID du groupe, de sorte que l'appareil atterrit dans le bon groupe lors de la première vérification.

Si vous ignorez ceci, l'appareil atterrit dansNon groupé— vous pouvez le déplacer après.

La clé d'installation

Chaque méthode d'installation Linux utilise un clé d'installation — un jeton court visible dans la modale qui relie les nouveaux appareils à votre compte Level. Il est strictement délimité : s'il est exposé, il ne peut pas accéder à votre compte, aux appareils existants ou à l'API Level. Le seul risque est que quelqu'un puisse l'utiliser pour ajouter des appareils à votre compte.

Si vous pensez que votre clé d'installation a été compromise, contactez le support Level pour la faire pivoter.

ℹ️ REMARQUE:La clé d'installation reflète votre sélection de groupe en temps réel. Sans groupe sélectionné, elle contient simplement votre identifiant de compte. Sélectionnez un groupe et l'ID du groupe est annexé.

Méthodes d'installation

La boîte de dialogue comporte deux onglets pour Linux.

Commande en une ligne

Une commande bash en une ligne qui télécharge et installe l'agent. C'est la méthode standard pour la plupart des déploiements Linux et gère la détection d'architecture automatiquement.

Dans la modale, sélectionnez leCommande en une ligne tab.
Sélectionnez facultativement un groupe d'appareils.
Copiez la commande générée.
Sur l'appareil cible, ouvrez un terminal.
Exécutez la commande. Si vous n'êtes pas déjà root, la commande inclut sudo— vous serez invité à entrer votre mot de passe.

L'appareil apparaît dans votre Liste des appareils dans 5 à 10 secondes après la fin de l'installation.

Programme d'installation

Télécharge un binaire spécifique à l'architecture et l'installe via la ligne de commande. Utilisez ceci lorsque vous devez spécifier explicitement l'architecture ou préférez un processus d'installation manuel.

Dans la modale, sélectionnez leProgramme d'installation tab.
Sélectionnez votre architecture dans la liste déroulante : x64 or ARM.
Sélectionnez facultativement un groupe d'appareils.
Click Télécharger le programme d'installationpour télécharger le binaire.
Copiez la commande d'installation affichée dans la boîte de dialogue.
Sur l'appareil cible, exécutez la commande copiée avec des permissions élevées.

La commande rend le binaire exécutable et exécute l'installation, enregistrant l'appareil avec votre compte en utilisant la clé d'installation intégrée.

Installation forcée (avancé)

Si une installation Level précédente a laissé des fichiers périmés, utilisez le forceInstallParamètre d'URL pour forcer un remplacement propre.

Accédez à:

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

This adds LEVEL_FORCE_INSTALL=trueà la commande générée d'une seule ligne.

⚠️ AVERTISSEMENT:Force install écrase toute configuration d'agent Level existante sur l'appareil. N'utilisez ceci que lorsqu'une installation standard échoue ou que le support Level vous le demande.

Configuration requise du système

Distributions prises en charge

Distribution	Version minimale
AlmaLinux	Version stable actuelle
Arch Linux	Version stable actuelle
CentOS	8
Debian	10
Fedora	36
Linux Mint	20
Photon OS (VMware)	Version stable actuelle
Raspbian (Système d'exploitation Raspberry Pi)	Version stable actuelle
Red Hat Enterprise Linux (RHEL)	8
Rocky Linux	8
Sangoma Linux	Version stable actuelle
Ubuntu	20.04 LTS

ℹ️ REMARQUE:D'autres distributions peuvent fonctionner mais ne sont pas officiellement supportées. Si vous rencontrez des problèmes sur une distro non répertoriée, contactez le support Level.

Dépendances requises

Les paquets suivants doivent être présents sur le système cible avant l'installation:

sudo
systemd(pour la gestion des services)
dbus or a UUID in /etc/machine-id
curl
ca-certificates
bash

La plupart des distributions prises en charge incluent celles-ci par défaut. Sur les installations minimales, vérifiez avant d'exécuter la commande d'installation Level.

Emplacements de stockage

Chemin	Objet
`/usr/local/bin/level`	Binaire de l'agent
`/var/lib/level`	Données de l'agent

Après l'installation

L'appareil apparaît dans votre Liste des appareils en 5 à 10 secondes et commence à remplir l'inventaire matériel en quelques minutes.

Si l'appareil n'apparaît pas, voirDépannage hors ligne for next steps.

FAQ

Dois-je exécuter la commande d'installation en tant que root? Oui, l'agent a besoin de permissions élevées pour installer. La commande d'une seule ligne inclutsudoautomatiquement. Pour l'installateur manuel, exécutez la commande avecsudo ou directement en tant que root.
Quelle architecture dois-je sélectionner dans l'onglet Installeur? Sélectionnez x64 pour les systèmes Intel/AMD 64 bits standard et ARM pour les appareils basés sur ARM (y compris Raspberry Pi). La méthode de commande d'une seule ligne gère automatiquement la détection d'architecture.
Ma distribution Linux n'est pas sur la liste prise en charge — Level fonctionnera-t-il quand même? Peut-être. Level supporte la plupart des distributions modernes exécutant systemd. Si votre distro respecte les conditions de dépendance, elle peut fonctionner correctement — contactez le support Level si vous rencontrez des problèmes.
L'appareil est installé mais n'apparaît pas dans Level — qu'est-ce qui ne va pas? Attendez 10 à 15 secondes et actualisez. Si elle n'apparaît toujours pas, vérifiez que systemd est en cours d'exécution et que toutes les dépendances requises ( curl, dbus , etc.) étaient présentes lors de l'installation. VoirDépannage hors ligne pour les étapes supplémentaires.
Que se passe-t-il si ma clé d'installation est compromise? La clé d'installation ne peut pas accéder à votre compte, aux appareils existants ou à l'API Level. Le seul risque est que quelqu'un ajoute des appareils à votre compte. Contactez le support Level pour faire pivoter la clé si nécessaire.
Puis-je déployer l'agent sur de nombreux appareils Linux à la fois? Oui — utilisez la commande d'une seule ligne avec vos outils existants (Ansible, Puppet, Chef, bash sur SSH, etc.).
Qui peut ajouter des appareils à Level? Tout technicien ayant la permission de gérer le groupe d'appareils cible, ou tout technicien en cas de déploiement sur Non groupé. Vérifier Espace de travail → Autorisations si vous ne voyez pas le Ajouter un nouvel appareil button.