Ir al contenido principal

Instalación en Linux

Install the Level agent on Linux devices using a one-line command or architecture-specific installer.

Introducción

El agente de Level es un servicio en segundo plano ligero que se comunica con tu cuenta y permite la supervisión remota, la automatización y la gestión de un dispositivo Linux. La instalación se realiza con 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 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 SO, elige Linux.

Linux Install

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 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 reducido: si se expone, 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 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. Al seleccionar un grupo, el ID del grupo se agrega al final.


Métodos de instalación

El modal tiene dos pestañas para Linux.

Comando de una línea

Un comando bash de una sola línea que descarga e instala el agente. Es el método estándar para la mayoría de las implementaciones en Linux y detecta la arquitectura automáticamente.

  1. En el modal, selecciona la Comando de una línea pestaña.

  2. Opcionalmente, selecciona un grupo de dispositivos.

  3. Copia el comando generado.

  4. En el dispositivo de destino, abre una terminal.

  5. Ejecuta el comando. Si aún no eres root, el comando incluye sudo: se te pedirá tu contraseña.

Linux One Line Installer

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 explícitamente o prefieras un proceso de instalación manual.

  1. En el modal, selecciona la Instalador pestaña.

  2. Selecciona tu arquitectura en el menú desplegable: x64 o ARM.

  3. Opcionalmente, selecciona un grupo de dispositivos.

  4. Haz clic en Descargar instalador para descargar el binario.

  5. Copia el comando de instalación que aparece en el modal.

  6. En el dispositivo de destino, ejecuta el comando copiado con permisos elevados.

Linux Installer

El comando hace que el binario sea ejecutable y lleva a cabo la instalación, registrando el dispositivo en tu cuenta mediante la clave de instalación incorporada.


Directorio de instalación personalizado

En sistemas Linux que ejecutan systemd, puedes elegir un directorio dedicado para el binario del agente, la configuración y los datos de la aplicación en lugar de las ubicaciones estándar. Elige el directorio durante la instalación. Esta opción no mueve una instalación existente a una nueva ruta.

Requisitos del directorio

  • Usa una ruta absoluta reservada para Level, como /srv/level. Para una instalación nueva, usa un directorio vacío. También puedes reutilizar un directorio que contenga una instalación de Level existente en esa misma ruta.

  • El sistema de archivos debe permitir escritura y ejecución. Un sistema de archivos de solo lectura o noexec no se puede usar.

  • El directorio debe ser propiedad de root, no debe permitir escritura por grupo u otros usuarios, y debe permitir que otros usuarios lo atraviesen. Sus directorios padre también deben ser controlados por root y ser atravesables por otros usuarios. Modo 755 es adecuado para un directorio de Level dedicado y propiedad de root.

  • Se permiten espacios si entrecomillas la ruta en el comando. No uses caracteres de control, comillas simples o dobles, signos de porcentaje, signos de dólar, barras inversas ni acentos graves en la ruta. No uses un directorio del sistema compartido como /, /mnt, /opt, /tmp, o /var/lib como raíz de instalación.

Comando de una línea con un directorio personalizado

  1. Copia tu comando de una línea para Linux desde Agregar nuevo dispositivo, incluyendo la clave de instalación y cualquier selección de grupo de dispositivos.

  2. Agrega LEVEL_INSTALL_DIR="/srv/level" antes de LEVEL_API_KEY=..., reemplazando la ruta de ejemplo con el directorio elegido. El directorio padre debe existir previamente. El script crea el directorio final de Level si no existe.

  3. Ejecuta el comando modificado. Por ejemplo, con tu clave de instalación sustituida por YOUR_INSTALL_KEY:

LEVEL_INSTALL_DIR="/srv/level" LEVEL_API_KEY="YOUR_INSTALL_KEY" bash -c "$(curl -L https://downloads.level.io/install_linux.sh)"

El script almacena su descarga en un directorio temporal privado dentro del directorio de instalación seleccionado y pasa ese directorio al instalador del agente. Usa la variable de entorno para el script de shell; usa --install-dir al ejecutar el binario del agente descargado directamente.

Instalador descargado con un directorio personalizado

Crea primero el directorio dedicado y asegúrate de que cumpla los requisitos anteriores. Agrega --install-dir "/srv/level" al comando de instalación generado. Para un instalador x64, el comando es:

chmod +x ./level-linux-amd64 && sudo ./level-linux-amd64 -k YOUR_INSTALL_KEY -a install --install-dir "/srv/level"

Reemplaza YOUR_INSTALL_KEY y la ruta antes de ejecutar el comando, y usa el binario correspondiente a la arquitectura de tu dispositivo. El binario descargado debe estar en un sistema de archivos ejecutable. Si un servicio de Level existente apunta a otro directorio de instalación, el instalador rechaza el cambio, incluso con la instalación forzada. Contacta con el soporte de Level antes de cambiar la ubicación de una instalación existente.

Almacenamiento en TrueNAS y persistencia tras reinicio

Para implementaciones de TrueNAS basadas en Linux, usa los requisitos de almacenamiento y arranque que se indican a continuación. Contacta con el soporte de Level para confirmar la compatibilidad con tu edición y versión exacta de TrueNAS antes de instalar.

  1. Elige un directorio o dataset de Level dedicado en un pool de almacenamiento ZFS bajo /mnt/, por ejemplo /mnt/tank/level. Reemplaza tank con el nombre de tu pool. No selecciones el pool de arranque ni la raíz del pool de almacenamiento en sí.

  2. Importa el pool, desbloquea cualquier dataset cifrado y monta el dataset de instalación antes de instalar. El dataset debe ser escribible y permitir la ejecución, y la ruta debe cumplir los requisitos de propiedad y permisos del directorio personalizado indicados anteriormente.

  3. Usa el comando de una línea con directorio personalizado indicado anteriormente con tu ruta de TrueNAS en LEVEL_INSTALL_DIR. El instalador verifica el dataset ZFS montado antes de continuar.

  4. Tras la instalación, verifica en TrueNAS Scripts de inicio/apagado para el Servicio de arranque del agente de Level tarea. Es una Comando tarea configurada en Post Init. Mantén esa tarea habilitada y conserva el directorio de instalación y sus archivos de inicio. No es necesario crear manualmente una segunda tarea de inicio.

El instalador guarda Level.service, 10-truenas.conf, y start-level.sh en el directorio de instalación. En el arranque, el comando Post Init espera hasta que el script de inicio guardado sea legible, comprobando cada 60 segundos. El script restaura la unidad de tiempo de ejecución en /run/systemd/system/Level.service y su archivo drop-in de requisito de montaje en /run/systemd/system/Level.service.d/10-truenas.conf, y luego inicia el servicio.

El dataset de instalación debe estar disponible para que el agente se ejecute. Si permanece cifrado y bloqueado tras el arranque, desbloquéalo y móntalo a través de tu flujo de trabajo habitual de almacenamiento de TrueNAS. La tarea de inicio no desbloquea el dataset por ti.


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 agrega 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

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 retardo 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. Las implementaciones rpm-ostree pendientes se detectan para las comprobaciones de reinicio.

ℹ️ NOTA: Otras distribuciones pueden funcionar, pero no son oficialmente compatibles. Si encuentras problemas con 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, verifícalos antes de ejecutar el comando de instalación de Level.


Ubicaciones de almacenamiento

Las rutas que se muestran a continuación son las ubicaciones estándar del binario y los datos. El archivo de configuración estándar es /etc/level/config.yaml.

Ruta

Propósito

/usr/local/bin/level

Binario del agente

/var/lib/level

Datos del agente

Almacenamiento en directorio personalizado

Con /srv/level seleccionado como directorio de instalación personalizado, Level utiliza:

  • /srv/level/bin/level para el binario del agente.

  • /srv/level/config.yaml para la configuración.

  • /srv/level para los datos de la aplicación, incluidos los registros y la base de datos local.

El servicio systemd conserva el directorio seleccionado en su --install-dir argumento. Para TrueNAS, sustituye tu /mnt/... ruta de instalación; los archivos de inicio guardados descritos anteriormente también permanecen en ese directorio.


Tras 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 pasos siguientes.


Preguntas frecuentes

  • ¿La clave de instalación es igual que una clave de API? No. La clave de instalación (desde Agregar nuevo dispositivo) solo inscribe dispositivos en tu cuenta. Las claves de API (desde Configuración → Claves de API) autentican herramientas externas contra la API de Level. No puedes instalar el agente con una clave de API. Usa la clave de instalación del modal de instalación. Consulta 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 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 Intel/AMD estándar de 64 bits y ARM para dispositivos basados en ARM (incluida Raspberry Pi). El método de comando de una línea detecta la arquitectura automáticamente.

  • ¿Puedo instalar Level en Fedora Silverblue o COSMIC Atomic? Sí. Esos sistemas rpm-ostree figuran en la tabla de compatibles. Usa el instalador nativo. El agente no escribe en rutas del sistema de solo lectura. Otras distribuciones inmutables pueden funcionar si cumplen los requisitos de dependencia, pero no se prueban oficialmente.

  • Mi distribución Linux no está en la lista de compatibles, ¿funcionará Level de todas formas? Es posible. Level es compatible con la mayoría de las distribuciones modernas que ejecutan systemd. Si tu distro cumple los requisitos de dependencia, es probable que funcione correctamente. Contacta con el soporte de Level si encuentras problemas.

  • El dispositivo se instaló pero no aparece en Level, ¿qué ocurre? 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é 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 con el soporte de Level para rotar 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 gestionar el grupo de dispositivos de destino, o cualquier técnico si se implementa en Sin grupo. Verifica en Espacio de trabajo → Permisos si no ves el Agregar nuevo dispositivo botón.

¿Ha quedado contestada tu pregunta?