Introduction

L'agent Level est un service d'arrière-plan léger qui se connecte à votre compte et permet la surveillance à distance, l'automatisation et la gestion d'un appareil Linux. L'installation s'effectue via 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 lors de la première connexion.

Si vous ignorez cette étape, l'appareil sera placé dans Non groupé — vous pourrez le déplacer par la suite.

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, à vos 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 pivoter.

ℹ️ 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 seule 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, en 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 précédente de Level a laissé des fichiers périmés, utilisez le forceInstall paramètre d'URL pour forcer un remplacement complet.

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	Version stable actuelle
Arch Linux	Version stable actuelle
CentOS	8
Debian	10
Fedora	36
Fedora Silverblue / COSMIC Atomic (rpm-ostree)	Version stable actuelle
Linux Mint	20
Photon OS (VMware)	Version stable actuelle
Raspbian (Raspberry Pi OS)	Version stable actuelle
Red Hat Enterprise Linux (RHEL)	8
Rocky Linux	8
Sangoma Linux	Version stable actuelle
Ubuntu	20.04 LTS

🖥️ NOTE DE PLATEFORME : Les systèmes rpm-ostree tels que Fedora Silverblue et COSMIC Atomic sont pris en charge. L'agent écrit son délai de redémarrage systemd via un fichier drop-in et stocke les entrées de bureau sous /usr/local/share, il n'écrit donc pas dans les chemins système en lecture seule. Les déploiements rpm-ostree en attente sont détectés pour les vérifications de redémarrage.

ℹ️ 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 incluent ces paquets 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 s'installer. 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 ARM (y compris le Raspberry Pi). La méthode par commande en une ligne gère automatiquement la détection de l'architecture.
Puis-je installer Level sur Fedora Silverblue ou COSMIC Atomic ? Oui. Ces systèmes rpm-ostree figurent dans le tableau des distributions prises en charge. Utilisez le programme d'installation natif — l'agent n'écrit pas dans les chemins système en lecture seule. D'autres distributions immuables peuvent fonctionner si elles satisfont aux exigences de dépendances, mais elles ne sont pas officiellement testées.
Ma distribution Linux ne figure pas dans la liste des distributions prises en charge — Level fonctionnera-t-il quand même ? C'est possible. Level prend en charge la plupart des distributions modernes exécutant systemd. Si votre distribution satisfait aux exigences de dépendances, elle devrait fonctionner correctement — contactez le support Level si vous rencontrez des problèmes.
L'appareil est installé mais n'apparaît pas dans Level — que se passe-t-il ? Attendez 10 à 15 secondes et actualisez. 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, à vos appareils existants, ni à 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 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 est effectué vers Non groupé. Vérifiez Espace de travail → Autorisations si vous ne voyez pas le Ajouter un nouvel appareil bouton.