Introducción

El agente de Level es un servicio en segundo plano liviano que se comunica con tu cuenta y permite la monitorización remota, la automatización y la gestión de un dispositivo Linux. La instalación es un único comando que se ejecuta 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

Haz clic en Agregar 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 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 la primera conexión.

Si omites este paso, el dispositivo quedará en Sin grupo — puedes moverlo después.

La clave de instalación

Todos los métodos de instalación en Linux utilizan 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 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 agregar dispositivos a tu cuenta.

Si crees que tu clave de instalación ha sido comprometida, contacta al 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. 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 en una línea

Un comando bash en 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 una terminal.
Ejecuta el comando. Si aún 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 la línea de comandos. Úsalo cuando necesites especificar la arquitectura de forma explícita 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 incorporada.

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 indique que lo hagas.

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 con una distro no incluida en la lista, contacta al soporte de Level.

Dependencias requeridas

Los siguientes paquetes deben estar presentes en el sistema de destino antes de la instalación:

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 su presencia 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 rellenar el inventario de hardware en pocos minutos.

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

Preguntas frecuentes

¿Necesito ejecutar el comando de instalación como root? Sí, el agente necesita permisos elevados para instalarse. El comando en 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 (incluido Raspberry Pi). El método de comando en una línea gestiona la detección de arquitectura automáticamente.
Mi distro de Linux no está en la lista de compatibles — ¿Level funcionará igualmente? 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 correctamente; contacta al soporte de Level si encuentras problemas.
El dispositivo se instaló pero no aparece en Level — ¿qué ocurre? Espera de 10 a 15 segundos y actualiza la página. 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 los pasos siguientes.
¿Qué ocurre si mi clave de instalación está 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 agregue dispositivos a tu cuenta. Contacta al soporte de Level para rotar la clave si es necesario.
¿Puedo implementar el agente en varios dispositivos Linux a la vez? Sí — usa el comando en 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 gestionar el grupo de dispositivos de destino, o cualquier técnico si se implementa en Sin grupo. Consulta Espacio de trabajo → Permisos si no ves el Agregar nuevo dispositivo botón.