Introducción
El agente Level es un servicio de fondo ligero que se sincroniza con su cuenta y pone a disposición la supervisión remota, la automatización y la administración para un dispositivo Linux. La instalación es un único comando ejecutado como root o con sudo.
⚙️ REQUISITOS PREVIOS
Una cuenta Level con permiso para agregar dispositivos
Acceso root o sudo en el dispositivo de destino
Una distribución Linux compatible ejecutando systemd
Paquetes requeridos:
curl,bash,ca-certificates,sudo,dbus(or a UUID in/etc/machine-id)
🎬 VIDEO
Instalación de Linux
Click Agregar nuevo dispositivo en la esquina superior derecha del Lista de dispositivospágina. En el selector del sistema operativo, elija Linux .
Seleccionar un grupo de dispositivos (opcional)
Seleccione un grupo de dispositivos antes de copiar su comando de instalación. La clave de instalación se actualiza para incluir el ID del grupo, por lo que el dispositivo llega al grupo correcto en el primer check-in.
Si omite esto, el dispositivo aterriza enSin agrupar— puede moverlo después.
La clave de instalación
Cada método de instalación de Linux usa un clave de instalación — un token corto visible en el modal que vincula nuevos dispositivos a su cuenta de Level. Tiene un alcance estrecho: si se expone, no puede acceder a su cuenta, dispositivos existentes o la API de Level. El único riesgo es que alguien podría usarlo para agregar dispositivos a su cuenta.
Si cree que su clave de instalación se ha visto comprometida, comuníquese con el soporte de Level para rotarla.
ℹ️ NOTA:La clave de instalación refleja su selección de grupo en tiempo real. Sin un grupo seleccionado, contiene solo su identificador de cuenta. Seleccione un grupo y se agrega la ID del grupo.
Métodos de instalación
El modal tiene dos pestañas para Linux.
Comando de una línea
Un comando bash de una línea que descarga e instala el agente. Este es el método estándar para la mayoría de las implementaciones de Linux y maneja la detección de arquitectura automáticamente.
En el modal, seleccione elComando de una línea tab.
Opcionalmente, seleccione un grupo de dispositivos.
Copie el comando generado.
En el dispositivo de destino, abra una terminal.
Ejecute el comando. Si aún no es root, el comando incluye
sudo— se le pedirá que ingrese su contraseña.
El dispositivo aparece en su Lista de dispositivos dentro de 5–10 segundos después de que se completa la instalación.
Instalador
Descarga un archivo binario específico de arquitectura e lo instala a través de la línea de comandos. Úselo cuando necesite especificar explícitamente la arquitectura o prefiera un proceso de instalación manual.
En el modal, seleccione elInstalador tab.
Seleccione su arquitectura en la lista desplegable: x64 or ARM.
Opcionalmente, seleccione un grupo de dispositivos.
Click Descargar instaladorpara descargar el binario.
Copie el comando de instalación que se muestra en el modal.
En el dispositivo de destino, ejecute el comando copiado con permisos elevados.
El comando hace que el archivo binario sea ejecutable y ejecuta la instalación, registrando el dispositivo con su cuenta usando la clave de instalación integrada.
Instalación forzada (avanzado)
Si una instalación anterior de Level dejó archivos obsoletos, use el forceInstallParámetro de URL para forzar una sobrescritura limpia.
Navegue a:
https://app.level.io/devices?forceInstall=true
This adds LEVEL_FORCE_INSTALL=trueal comando de una línea generado.
⚠️ ADVERTENCIA:Force install sobrescribe cualquier configuración de agente Level existente en el dispositivo. Solo use esto cuando una instalación estándar falla o el soporte de Level le indica que lo haga.
Requisitos del sistema
Distribuciones compatibles
Distribución | Versión mínima |
AlmaLinux | Versión estable actual |
Arch Linux | Versión estable actual |
CentOS | 8 |
Debian | 10 |
Fedora | 36 |
Linux Mint | 20 |
Photon OS (VMware) | Versión estable actual |
Raspbian (Raspberry Pi OS) | Versión estable actual |
Red Hat Enterprise Linux (RHEL) | 8 |
Rocky Linux | 8 |
Sangoma Linux | Versión estable actual |
Ubuntu | 20.04 LTS |
ℹ️ NOTA:Otras distribuciones pueden funcionar pero no se admiten oficialmente. Si experimenta problemas en una distribución no incluida, comuníquese con el soporte de Level.
Dependencias requeridas
Los siguientes paquetes deben estar presentes en el sistema de destino antes de instalar:
sudosystemd(para la administración de servicios)dbusor a UUID in/etc/machine-idcurlca-certificatesbash
La mayoría de las distribuciones compatible incluyen estas de manera predeterminada. En las instalaciones mínimas, verifique antes de ejecutar el comando de instalación de Level.
Ubicaciones de almacenamiento
Ruta | Propósito |
| Archivo binario del agente |
| Datos del agente |
Después de la instalación
El dispositivo aparece en su Lista de dispositivos dentro de 5–10 segundos y comienza a completar el inventario de hardware en unos minutos.
Si el dispositivo no aparece, consulteSolución de problemas sin conexión for next steps.
Preguntas frecuentes
¿Necesito ejecutar el comando de instalación como root? Sí, el agente necesita permisos elevados para instalar. El comando de una línea incluye
sudoautomáticamente. Para el instalador manual, ejecute el comando consudoo directamente como root.¿Qué arquitectura debo seleccionar en la pestaña Instalador? Seleccione x64 para sistemas Intel/AMD de 64 bits estándar y ARM para dispositivos basados en ARM (incluida Raspberry Pi). El método de comando de una línea maneja la detección de arquitectura automáticamente.
Mi distribución de Linux no está en la lista compatible — ¿Level seguirá funcionando? Posiblemente. Level admite la mayoría de distribuciones modernas que ejecutan systemd. Si su distribución cumple con los requisitos de dependencia, puede funcionar correctamente — comuníquese con el soporte de Level si experimenta problemas.
El dispositivo está instalado pero no aparece en Level — ¿qué está mal? Espere 10–15 segundos y actualice. Si aún no aparece, verifique que systemd se esté ejecutando y que todas las dependencias requeridas (
curl,dbus, etc.) estuvieran presentes durante la instalación. VerSolución de problemas sin conexión para pasos adicionales.¿Qué pasa si mi clave de instalación se ve comprometida? La clave de instalación no puede acceder a su cuenta, dispositivos existentes o la API de Level. El único riesgo es que alguien agregue dispositivos a su cuenta. Comuníquese con el soporte de Level para rotar la clave si es necesario.
¿Puedo desplegar el agente en muchos dispositivos Linux a la vez? Sí — use el comando de una línea con su herramienta existente (Ansible, Puppet, Chef, bash sobre SSH, etc.).
¿Quién puede agregar dispositivos a Level? Cualquier técnico con permiso para administrar el grupo de dispositivos de destino, o cualquier técnico si implementa en Sin agrupar. Comprobar Espacio de trabajo → Permisos si no ve el Agregar nuevo dispositivo button.