Introducción
El agente de Level es un servicio en segundo plano ligero que se comunica con su cuenta y pone a disposición la monitorización remota, la automatización y la gestión para un dispositivo Linux. La instalación es un único comando ejecutado como root o con sudo.
⚙️ REQUISITOS PREVIOS
Una cuenta de Level con permiso para agregar dispositivos
Acceso root o sudo en el dispositivo de destino
Una distribución de Linux compatible que ejecute systemd
Paquetes requeridos:
curl,bash,ca-certificates,sudo,dbus(o un UUID en/etc/machine-id)
🎬 VÍDEO
Instalación en Linux
Haga clic en Agregar nuevo dispositivo en la esquina superior derecha de la Listado de dispositivos página. En el selector de sistema operativo, elija Linux.
Selección de un grupo de dispositivos (opcional)
Seleccione un grupo de dispositivos antes de copiar el comando de instalación. La clave de instalación se actualiza para incluir el ID del grupo, de modo que el dispositivo quede en el grupo correcto en el primer registro.
Si omite este paso, el dispositivo quedará en Sin grupo — puede moverlo después.
La clave de instalación
Cada método de instalación en Linux utiliza una clave de instalación — un token corto visible en el modal que vincula los nuevos dispositivos a su cuenta de Level. Su alcance es reducido: si queda expuesto, no puede acceder a su cuenta, a los dispositivos existentes ni a la API de Level. El único riesgo es que alguien pueda usarlo para agregar dispositivos a su cuenta.
Si cree que su clave de instalación ha sido comprometida, contacte con el soporte de Level para rotarla.
ℹ️ NOTA: La clave de instalación refleja la selección de grupo en tiempo real. Sin un grupo seleccionado, contiene solo el identificador de su cuenta. Al seleccionar un grupo, se añade el ID del grupo.
Métodos de instalación
El modal tiene dos pestañas para Linux.
Comando de una sola línea
Un comando bash de una sola línea que descarga e instala el agente. Este es el método estándar para la mayoría de las implementaciones en Linux y gestiona la detección de arquitectura automáticamente.
En el modal, seleccione la Comando de una línea pestaña.
Opcionalmente, seleccione un grupo de dispositivos.
Copie el comando generado.
En el dispositivo de destino, abra una terminal.
Ejecute el comando. Si no es root, el comando incluye
sudo— se le pedirá su contraseña.
El dispositivo aparece en su Listado de dispositivos en un plazo de 5 a 10 segundos tras completarse la instalación.
Instalador
Descarga un binario específico para la arquitectura y lo instala mediante la línea de comandos. Utilice esta opción cuando necesite especificar la arquitectura explícitamente o prefiera un proceso de instalación manual.
En el modal, seleccione la Instalador pestaña.
Seleccione su arquitectura en el menú desplegable: x64 o ARM.
Opcionalmente, seleccione un grupo de dispositivos.
Haga clic en Descargar instalador para 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 binario sea ejecutable y ejecuta la instalación, registrando el dispositivo en su cuenta mediante la clave de instalación incorporada.
Instalación forzada (avanzado)
Si una instalación anterior de Level dejó archivos obsoletos, use el forceInstall parámetro de URL para forzar una sobreescritura limpia.
Navegue a:
https://app.level.io/devices?forceInstall=true
Esto añade LEVEL_FORCE_INSTALL=true al comando de una línea generado.
⚠️ ADVERTENCIA: La instalación forzada sobreescribe cualquier configuración existente del agente de Level en el dispositivo. Úsela únicamente cuando una instalación estándar falle o cuando el soporte de Level se lo indique.
Requisitos del sistema
Distribuciones compatibles
Distribución | Versión mínima |
AlmaLinux | Estable actual |
Arch Linux | Estable actual |
CentOS | 8 |
Debian | 10 |
Fedora | 36 |
Fedora Silverblue / COSMIC Atomic (rpm-ostree) | Estable actual |
Linux Mint | 20 |
Photon OS (VMware) | Estable actual |
Raspbian (Raspberry Pi OS) | Estable actual |
Red Hat Enterprise Linux (RHEL) | 8 |
Rocky Linux | 8 |
Sangoma Linux | Estable actual |
Ubuntu | 20.04 LTS |
🖥️ NOTA DE PLATAFORMA: Los sistemas rpm-ostree como Fedora Silverblue y COSMIC Atomic son compatibles. El agente escribe su retraso de reinicio de systemd a través de un archivo drop-in y almacena las entradas de escritorio en /usr/local/share, por lo que no escribe en rutas del sistema de solo lectura. Los despliegues de rpm-ostree pendientes se detectan para las comprobaciones de reinicio.
ℹ️ NOTA: Otras distribuciones pueden funcionar, pero no son oficialmente compatibles. Si tiene problemas con una distribución no listada, contacte con el soporte de Level.
Dependencias requeridas
Los siguientes paquetes deben estar presentes en el sistema de destino antes de instalar:
sudosystemd(para la gestión de servicios)dbuso un UUID en/etc/machine-idcurlca-certificatesbash
La mayoría de las distribuciones compatibles los incluyen por defecto. En instalaciones mínimas, verifique antes de ejecutar el comando de instalación de Level.
Ubicaciones de almacenamiento
Ruta | Propósito |
| Binario del agente |
| Datos del agente |
Después de la instalación
El dispositivo aparece en su Listado de dispositivos en 5 a 10 segundos y comienza a completar el inventario de hardware en pocos minutos.
Si el dispositivo no aparece, consulte Solución de problemas sin conexión para los pasos siguientes.
Preguntas frecuentes
¿La clave de instalación es lo mismo que una clave de API? No. La clave de instalación (de Agregar nuevo dispositivo) solo registra dispositivos en su cuenta. Las claves de API (de Configuración → Claves de API) autentican herramientas externas contra la API de Level. No puede instalar el agente con una clave de API — use la clave de instalación del modal de instalación. Consulte Configuración de claves de API.
¿Necesito ejecutar el comando de instalación como root? Sí, el agente necesita permisos elevados para instalarse. 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 estándar de 64 bits Intel/AMD y ARM para dispositivos basados en ARM (incluida Raspberry Pi). El método de comando de una línea gestiona la detección de arquitectura automáticamente.
¿Puedo instalar Level en Fedora Silverblue o COSMIC Atomic? Sí. Esos sistemas rpm-ostree están en la tabla de compatibilidad. Use el instalador nativo — el agente no escribe en rutas del sistema de solo lectura. Otras distribuciones inmutables pueden funcionar si cumplen los requisitos de dependencias, pero no se prueban oficialmente.
Mi distribución de Linux no está en la lista de compatibles — ¿Level seguirá funcionando? Es posible. Level es compatible con la mayoría de las distribuciones modernas que ejecutan systemd. Si su distribución cumple los requisitos de dependencias, puede funcionar correctamente — contacte con el soporte de Level si tiene problemas.
El dispositivo se instaló pero no aparece en Level — ¿qué ocurre? Espere 10-15 segundos y actualice. Si aún no aparece, verifique que systemd esté en ejecución y que todas las dependencias requeridas (
curl,dbus, etc.) estaban presentes durante la instalación. Consulte Solución de problemas sin conexión para más pasos.¿Qué ocurre si mi clave de instalación está comprometida? La clave de instalación no puede acceder a su cuenta, a los dispositivos existentes ni a la API de Level. El único riesgo es que alguien agregue dispositivos a su cuenta. Contacte con el soporte de Level para rotar la clave si es necesario.
¿Puedo implementar el agente en muchos dispositivos Linux a la vez? Sí — use el comando de una línea con sus herramientas existentes (Ansible, Puppet, Chef, bash por SSH, etc.).
¿Quién puede agregar dispositivos a Level? Cualquier técnico con permiso para gestionar el grupo de dispositivos de destino, o cualquier técnico si se implementa en Sin grupo. Consulte Espacio de trabajo → Permisos si no ve el Agregar nuevo dispositivo botón.