L'agent Level est un service de fond léger qui vérifie votre compte et rend disponibles la surveillance à distance, l'automatisation et la gestion 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 permission d'ajouter des appareils
Accès root ou sudo sur l'appareil cible
Une distribution Linux prise en charge 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 page Liste des appareils. Dans le sélecteur du système d'exploitation, choisissez Linux.

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

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

Si vous ignorez cette étape, l'appareil se place dans Non groupé — vous pouvez 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. Elle est limitée étroitement: si elle est exposée, elle 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 juste votre identifiant de compte. Sélectionnez un groupe et l'ID du groupe est ajouté.

Méthodes d'installation

La fenêtre modale a deux onglets pour Linux.

Commande une ligne

Une commande bash sur 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 fenêtre modale, sélectionnez l'onglet Commande une ligne.
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 — vous serez invité à entrer votre mot de passe.

L'appareil s'affiche dans votre Liste des appareils dans 5 à 10 secondes après l'installation.

Programme d'installation

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

Dans la fenêtre modale, sélectionnez l'onglet Programme d'installation.
Sélectionnez votre architecture dans la liste déroulante: 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 les permissions élevées.

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

Installation forcée (Avancé)

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

Accédez à:

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

Ceci ajoute LEVEL_FORCE_INSTALL=true à la commande générée sur une ligne.

⚠️ AVERTISSEMENT: L'installation forcée remplace toute configuration d'agent Level existante sur l'appareil. Utilisez ceci uniquement quand une installation standard échoue ou quand le support Level vous y invite.

Configuration système 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 sur une distribution non listé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 éléments par défaut. Sur les installations minimales, vérifiez avant d'exécuter la commande d'installation Level.

Emplacements de stockage

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

Après installation

L'appareil s'affiche dans votre Liste des appareils dans 5 à 10 secondes et commence à remplir l'inventaire matériel dans quelques minutes.

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

Foire aux questions

Dois-je exécuter la commande d'installation en tant que root? Oui, l'agent a besoin des permissions élevées pour installer. La commande sur 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 du programme d'installation? 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 une ligne gère la détection d'architecture automatiquement.
Ma distribution Linux n'est pas sur la liste prise en charge — Level fonctionnera-t-il toujours? Peut-être. Level prend en charge la plupart des distributions modernes exécutant systemd. Si votre distribution répond aux exigences de dépendance, cela peut fonctionner correctement — contactez le support Level si vous rencontrez des problèmes.
L'appareil a été installé mais ne s'affiche pas dans Level — qu'est-ce qui ne va pas? Attendez 10 à 15 secondes et actualisez. S'il ne s'affiche toujours pas, vérifiez que systemd fonctionne et que toutes les dépendances requises (curl, dbus, etc.) étaient présentes lors de l'installation. Consultez Dépannage hors ligne pour les étapes suivantes.
Et 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 une 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érifiez Espace de travail → Permissions si vous ne voyez pas le bouton Ajouter un nouvel appareil.