Introducción

El agente de Level es un servicio en segundo plano ligero que se conecta con tu 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 añadir dispositivos
Acceso root o sudo en el dispositivo de destino
Una distribución 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

Haz clic en Añadir nuevo dispositivo en la esquina superior derecha de la Listado de dispositivos página. En el selector de sistema operativo, elige Linux.

Seleccionar 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 quede en el grupo correcto en el primer registro.

Si omites esto, el dispositivo quedará en Sin grupo — puedes 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 tu cuenta de Level. Tiene un alcance muy limitado: si queda expuesta, no puede acceder a tu cuenta, a los dispositivos existentes ni a la API de Level. El único riesgo es que alguien pueda usarla para añadir dispositivos a tu cuenta.

Si crees que tu clave de instalación ha sido comprometida, contacta con el soporte de Level para rotarla.

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

Métodos de instalación

El modal tiene dos pestañas para Linux.

Comando en una 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, selecciona la Comando en una línea pestaña.
Opcionalmente, selecciona un grupo de dispositivos.
Copia el comando generado.
En el dispositivo de destino, abre un terminal.
Ejecuta el comando. Si no eres root, el comando incluye sudo — se te pedirá tu contraseña.

El dispositivo aparece en tu 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 línea de comandos. Úsalo cuando necesites especificar la arquitectura explícitamente o prefieras un proceso de instalación manual.

En el modal, selecciona la Instalador pestaña.
Selecciona tu arquitectura en el 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 que se muestra en el modal.
En el dispositivo de destino, ejecuta el comando copiado con permisos elevados.

El comando hace que el binario sea ejecutable y ejecuta la instalación, registrando el dispositivo en tu cuenta mediante la clave de instalación integrada.

Instalación forzada (avanzado)

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

Navega 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. Úsala solo cuando una instalación estándar falle o 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 tienen soporte oficial. Si encuentras problemas en una distro no incluida en la lista, contacta con el soporte de Level.

Dependencias requeridas

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

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

La mayoría de las distribuciones compatibles los incluyen por defecto. En instalaciones mínimas, verifica esto 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 Listado de dispositivos en un plazo de 5 a 10 segundos y comienza a poblar el inventario de hardware en pocos minutos.

Si el dispositivo no aparece, consulta Solución de problemas sin conexión para los próximos pasos.

Preguntas frecuentes

¿Necesito ejecutar el comando de instalación como root? Sí, el agente necesita permisos elevados para instalarse. 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 Instalador? Selecciona 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 en una línea gestiona la detección de arquitectura automáticamente.
Mi distro 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 tu distro cumple los requisitos de dependencias, puede que funcione perfectamente — contacta con el soporte de Level si encuentras problemas.
El dispositivo se instaló pero no aparece en Level — ¿qué está pasando? Espera 10–15 segundos y actualiza. Si sigue sin aparecer, verifica que systemd esté en ejecución y que todas las dependencias requeridas (curl, dbus, etc.) estaban presentes durante la instalación. Consulta Solución de problemas sin conexión para más pasos.
¿Qué pasa si mi clave de instalación se ve comprometida? La clave de instalación no puede acceder a tu cuenta, a los dispositivos existentes ni a la API de Level. El único riesgo es que alguien añada dispositivos a tu cuenta. Contacta con el soporte de Level para rotar la clave si es necesario.
¿Puedo desplegar 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 añadir dispositivos a Level? Cualquier técnico con permiso para gestionar el grupo de dispositivos de destino, o cualquier técnico si se despliega en Sin grupo. Consulta Workspace → Permissions si no ves el Añadir nuevo dispositivo botón.