Introduction

L'agent Level est un service d'arrière-plan léger qui s'enregistre auprès de votre compte et permet la surveillance à distance, l'automatisation et la gestion d'un appareil Linux. L'installation se fait avec une seule commande exécutée en tant que root ou avec sudo.

⚙️ PRÉREQUIS

Un compte Level avec l'autorisation d'ajouter des appareils
Accès root ou sudo sur l'appareil cible
Une distribution Linux compatible exécutant systemd
Paquets requis : curl, bash, ca-certificates, sudo, dbus (ou un UUID dans /etc/machine-id)

🎬 VIDÉO

Installation Linux

Cliquez sur Ajouter un nouvel appareil dans le coin supérieur droit de la Liste des appareils page. Dans le sélecteur de 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'identifiant du groupe, afin que l'appareil rejoigne le bon groupe dès le premier enregistrement.

Si vous ignorez cette étape, l'appareil se retrouve dans Non groupé — vous pourrez le déplacer ensuite.

La clé d'installation

Chaque méthode d'installation Linux utilise une clé d'installation — un jeton court visible dans la fenêtre modale qui relie les nouveaux appareils à votre compte Level. Sa portée est étroitement limitée : si elle est exposée, elle ne peut pas accéder à votre compte, aux appareils existants ni à 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 renouveler.

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

Méthodes d'installation

La fenêtre modale comporte deux onglets pour Linux.

Commande en une ligne

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

Dans la fenêtre modale, sélectionnez l'onglet Commande en une ligne onglet.
Sélectionnez éventuellement 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 — votre mot de passe vous sera demandé.

L'appareil apparaît dans votre Liste des appareils dans les 5 à 10 secondes suivant 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 cette méthode lorsque vous devez spécifier l'architecture explicitement ou si vous préférez un processus d'installation manuel.

Dans la fenêtre modale, sélectionnez l'onglet Programme d'installation onglet.
Sélectionnez votre architecture dans le menu déroulant : x64 ou ARM.
Sélectionnez éventuellement un groupe d'appareils.
Cliquez sur Télécharger le programme d'installation pour télécharger le binaire.
Copiez la commande d'installation affichée dans la fenêtre modale.
Sur l'appareil cible, exécutez la commande copiée avec des permissions élevées.

La commande rend le binaire exécutable et lance l'installation, enregistrant l'appareil auprès de votre compte à l'aide de la clé d'installation intégrée.

Installation forcée (avancé)

Si une installation Level précédente a laissé des fichiers obsolètes, utilisez le forceInstall paramètre URL pour forcer un écrasement propre.

Accédez à :

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

Cela ajoute LEVEL_FORCE_INSTALL=true à la commande en une ligne générée.

⚠️ AVERTISSEMENT : L'installation forcée écrase toute configuration existante de l'agent Level sur l'appareil. N'utilisez cette option que lorsqu'une installation standard échoue ou que le support Level vous y invite.

Configuration requise

Distributions prises en charge

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

ℹ️ REMARQUE : D'autres distributions peuvent fonctionner mais ne sont pas officiellement prises en charge. Si vous rencontrez des problèmes avec une distribution 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 ou un UUID dans /etc/machine-id
curl
ca-certificates
bash

La plupart des distributions prises en charge les incluent par défaut. Pour les installations minimales, vérifiez leur présence avant d'exécuter la commande d'installation Level.

Emplacements de stockage

Chemin	Fonction
`/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 dans les 5 à 10 secondes et commence à renseigner l'inventaire matériel en quelques minutes.

Si l'appareil n'apparaît pas, consultez Dépannage hors ligne pour les étapes suivantes.

FAQ

Dois-je exécuter la commande d'installation en tant que root ? Oui, l'agent nécessite des permissions élevées pour l'installation. La commande en une ligne inclut sudo automatiquement. Pour le programme d'installation manuel, exécutez la commande avec sudo ou directement en tant que root.
Quelle architecture dois-je sélectionner dans l'onglet Programme d'installation ? Sélectionnez x64 pour les systèmes Intel/AMD 64 bits standard et ARM pour les appareils à base d'ARM (y compris Raspberry Pi). La méthode par commande en une ligne gère automatiquement la détection de l'architecture.
Ma distribution Linux ne figure pas sur la liste des distributions prises en charge — Level fonctionnera-t-il quand même ? Peut-être. Level prend en charge la plupart des distributions modernes exécutant systemd. Si votre distribution satisfait aux exigences de dépendances, 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 — quel est le problème ? Attendez 10 à 15 secondes et actualisez la page. Si l'appareil 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ésents lors de l'installation. Consultez Dépannage hors ligne pour les étapes suivantes.
Que faire si ma clé d'installation est compromise ? La clé d'installation ne peut pas accéder à votre compte, aux appareils existants ni à l'API Level. Le seul risque est que quelqu'un ajoute des appareils à votre compte. Contactez le support Level pour faire renouveler la clé si nécessaire.
Puis-je déployer l'agent sur plusieurs appareils Linux à la fois ? Oui — utilisez la commande en une ligne avec vos outils existants (Ansible, Puppet, Chef, bash via SSH, etc.).
Qui peut ajouter des appareils à Level ? Tout technicien ayant l'autorisation de gérer le groupe d'appareils cible, ou tout technicien si le déploiement se fait vers Non groupé. Vérifiez Espace de travail → Permissions si vous ne voyez pas le bouton Ajouter un nouvel appareil bouton.