El agente de Level es un servicio de fondo ligero que verifica tu cuenta y permite 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 de Level con permiso para agregar dispositivos
Acceso root o sudo en el dispositivo objetivo
Una distribución Linux compatible ejecutando systemd
Paquetes requeridos: curl, bash, ca-certificates, sudo, dbus (o un UUID en /etc/machine-id)

🎬 VÍDEO

Instalación de Linux

Haz clic en Agregar nuevo dispositivo en la esquina superior derecha de la página Lista de dispositivos. En el selector de sistema operativo, elige Linux.

Selección de un grupo de dispositivos (Opcional)

Selecciona un grupo de dispositivos antes de copiar tu comando de instalación. La clave de instalación se actualiza para incluir el ID del grupo, de modo que el dispositivo llegue al grupo correcto en el primer check-in.

Si omites esto, el dispositivo va a Sin agrupar — puedes moverlo después.

La clave de instalación

Cada método de instalación de Linux utiliza una clave de instalación — un token corto visible en el modal que vincula nuevos dispositivos con tu cuenta de Level. Está muy limitada: si se expone, no puede acceder a tu cuenta, dispositivos existentes o la API de Level. El único riesgo es que alguien pueda usarla para agregar dispositivos a tu cuenta.

Si crees que tu clave de instalación ha sido comprometida, contacta al soporte de Level para cambiarla.

ℹ️ NOTA: La clave de instalación refleja tu selección de grupo en tiempo real. Sin un grupo seleccionado, contiene solo tu identificador de cuenta. Selecciona un grupo y el ID del grupo se agrega.

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 implementaciones de Linux y maneja la detección de arquitectura automáticamente.

En el modal, selecciona la pestaña Comando de una línea.
Opcionalmente selecciona un grupo de dispositivos.
Copia el comando generado.
En el dispositivo objetivo, abre una terminal.
Ejecuta el comando. Si no eres root, el comando incluye sudo — se te pedirá tu contraseña.

El dispositivo se muestra en tu Lista de dispositivos dentro de 5 a 10 segundos después de completar la instalación.

Instalador

Descarga un binario específico de la arquitectura e lo instala a través de la línea de comandos. Usa esto cuando necesites especificar la arquitectura explícitamente o prefieras un proceso de instalación manual.

En el modal, selecciona la pestaña Instalador.
Selecciona tu arquitectura del menú desplegable: x64 o ARM.
Opcionalmente selecciona un grupo de dispositivos.
Haz clic en Descargar instalador para descargar el binario.
Copia el comando de instalación mostrado en el modal.
En el dispositivo objetivo, ejecuta el comando copiado con permisos elevados.

El comando hace el binario ejecutable y ejecuta la instalación, registrando el dispositivo con tu cuenta usando la clave de instalación integrada.

Instalación forzada (Avanzado)

Si una instalación anterior de Level dejó archivos obsoletos, usa el parámetro URL forceInstall para forzar una sobrescritura limpia.

Navega a:

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

Esto agrega LEVEL_FORCE_INSTALL=true al comando generado de una línea.

⚠️ ADVERTENCIA: La instalación forzada sobrescribe cualquier configuración de agente de Level existente en el dispositivo. Usa esto solo cuando falle una instalación estándar o cuando el soporte de Level te 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
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: Otras distribuciones pueden funcionar pero no son oficialmente compatibles. Si tienes problemas en una distribución no listada, contacta al soporte de Level.

Dependencias requeridas

Los siguientes paquetes deben estar presentes en el sistema objetivo antes de instalar:

sudo
systemd (para gestión de servicios)
dbus o un UUID en /etc/machine-id
curl
ca-certificates
bash

La mayoría de distribuciones compatibles incluyen estos por defecto. En instalaciones mínimas, verifica antes de ejecutar el comando de instalación de Level.

Ubicaciones de almacenamiento

Ruta	Propósito
`/usr/local/bin/level`	Binario del agente
`/var/lib/level`	Datos del agente

Después de la instalación

El dispositivo aparece en tu Lista de dispositivos dentro de 5 a 10 segundos y comienza a poblar el inventario de hardware en algunos minutos.

Si el dispositivo no aparece, ver Solución de problemas fuera de línea para los próximos pasos.

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 sudo automáticamente. Para el instalador manual, ejecuta el comando con sudo o directamente como root.
¿Qué arquitectura debo seleccionar en la pestaña del instalador? Selecciona x64 para sistemas Intel/AMD de 64 bits estándar y ARM para dispositivos basados en ARM (incluyendo 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 de compatibles — ¿Level seguirá funcionando? Posiblemente. Level compatible con la mayoría de distribuciones modernas que ejecutan systemd. Si tu distribución cumple con los requisitos de dependencia, probablemente funcione bien — contacta al soporte de Level si encuentras problemas.
El dispositivo se instaló pero no aparece en Level — ¿qué está mal? Espera 10 a 15 segundos y actualiza. Si aún no aparece, verifica que systemd se está ejecutando y que todas las dependencias requeridas (curl, dbus, etc.) estaban presentes durante la instalación. Ver Solución de problemas fuera de línea para más pasos.
¿Qué pasa si mi clave de instalación está comprometida? La clave de instalación no puede acceder a tu cuenta, dispositivos existentes o la API de Level. El único riesgo es que alguien pueda agregar dispositivos a tu cuenta. Contacta al soporte de Level para cambiar la clave si es necesario.
¿Puedo implementar el agente en muchos dispositivos Linux a la vez? Sí — usa el comando de una línea con tus herramientas existentes (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 objetivo, o cualquier técnico si implementa a Sin agrupar. Verifica Espacio de trabajo → Permisos si no ves el botón Agregar nuevo dispositivo.