Ir al contenido principal

Instalación en macOS

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

Introducción

El agente de Level es un servicio en segundo plano liviano que se comunica con tu cuenta y pone a disposición el control remoto, la monitorización, la automatización y la gestión de parches para un dispositivo. Instalarlo en macOS lleva un par de minutos, con algunos permisos que deben concederse tras la primera instalación.


⚙️ REQUISITOS PREVIOS

  • Una cuenta de Level con permiso para agregar dispositivos

  • Derechos de administrador local en el dispositivo macOS de destino

  • macOS 11 (Big Sur) o posterior


🎬 VÍDEO


Instalación en macOS

Abrir el modal de instalación

Haz clic en Agregar nuevo dispositivo en la esquina superior derecha de la Listado de dispositivos página. En el selector de SO, elige macOS.

macOS Install Modal

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 automáticamente en el primer registro.

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

💡 CONSEJO: Asignar un grupo en el momento de la instalación significa que el dispositivo recoge de inmediato todas las automatizaciones y permisos a nivel de grupo.


La clave de instalación

Todos los métodos de instalación en macOS usan una clave de instalación — un token corto visible en el modal que vincula los nuevos dispositivos a tu cuenta de Level. Está diseñado con un alcance reducido: si queda expuesto, no puede acceder a tu cuenta, a los dispositivos existentes ni a la API de Level. El único riesgo es que alguien pueda usarlo 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 añade al final.


Métodos de instalación

El modal tiene dos pestañas para macOS.

Comando de una línea

Un comando curl de una sola línea que descarga e instala el agente. Este es el método más rápido y funciona en cualquier arquitectura compatible sin necesidad de seleccionarla manualmente.

  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 Terminal.

  5. Pega y ejecuta el comando. Es posible que se te solicite la contraseña de administrador.

One-Line Command Installer

El dispositivo aparece en tu Listado de dispositivos dentro de 5–10 segundos tras completarse la instalación.

Instalador

Descarga un PKG específico para la arquitectura y lo instala manualmente. Úsalo cuando quieras una guía visual o necesites especificar la arquitectura de forma explícita.

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

  2. Selecciona tu arquitectura en el menú desplegable: x64 (Intel) o ARM64 (Apple Silicon).

  3. Opcionalmente, selecciona un grupo de dispositivos.

  4. Haz clic en Descargar instalador para descargar el archivo PKG.

  5. Instala usando cualquiera de estos métodos:

    • GUI: Haz doble clic en el PKG descargado y sigue el asistente de instalación.

    • Terminal: Copia el comando que aparece en el modal y ejecútalo en Terminal.

macOS Installer Download

ℹ️ NOTA: El comando de terminal que aparece en el modal (sudo installer -pkg ./level-darwin-bundle-amd64.pkg ...) ejecuta el PKG de forma no interactiva y registra el dispositivo en tu cuenta en un solo paso. El asistente GUI solicita la clave de instalación por separado.

🖥️ NOTA DE PLATAFORMA:

  • Intel (x64): Selecciona x64 en el menú desplegable de arquitectura.

  • Apple Silicon (M1/M2/M3): Selecciona ARM64. Level usa una cuenta de servicio en dispositivos Apple Silicon para admitir la gestión de parches — se te pedirán credenciales de administrador tras completarse la instalación. Este es el comportamiento esperado.


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.

ℹ️ NOTA: forceInstall=true es un parámetro de URL destinado a escenarios de soporte. El soporte de Level puede enviarte directamente a una URL de modal preconfigurada durante la resolución de problemas.

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.


Tras la instalación: Permisos

macOS requiere concesiones de permisos explícitas para el control remoto, la grabación de pantalla y el acceso a archivos. Tras instalar el agente, concede acceso a Level en las tres ubicaciones dentro de Configuración del sistema → Privacidad & Seguridad:

  • Grabación de pantalla

  • Accesibilidad

  • Acceso total al disco

Necesitarás credenciales de administrador para realizar estos cambios.

ℹ️ NOTA: El modal de instalación enumera estos tres permisos como recordatorio en la parte inferior de ambas pestañas de instalación.


Despliegue MDM: perfil mobileconfig (opcional)

💡 CONSEJO: Si vas a desplegar en muchos dispositivos macOS, usa el perfil mobileconfig descrito a continuación. Concede silenciosamente Accesibilidad y Acceso total al disco mediante MDM, y permite que usuarios sin privilegios de administrador aprueben el aviso de Grabación de pantalla sin necesitar credenciales de administrador.

Para entornos gestionados por MDM, puedes desplegar un perfil mobileconfig PPPC (Privacy Preferences Policy Control) para agilizar la configuración de permisos posterior a la instalación.

El perfil gestiona la Accesibilidad y el Acceso total al disco de forma silenciosa mediante la política MDM. La Grabación de pantalla es un permiso de privacidad protegido que Apple no permite conceder silenciosamente mediante MDM — en su lugar, el perfil permite que los usuarios sin privilegios de administrador aprueben el aviso de Grabación de pantalla ellos mismos, sin necesitar credenciales de administrador.

⚠️ ADVERTENCIA: El archivo mobileconfig proporcionado por Level es solo una muestra. Level no ofrece soporte para crear, gestionar ni solucionar problemas de configuraciones MDM — el comportamiento varía según el proveedor de MDM. Pruébalo en tu propio entorno antes de desplegarlo ampliamente.

Para desplegar:

  1. Descarga el perfil mobileconfig: Descargar Level - PPPC.mobileconfig

  2. Envíalo mediante tu herramienta MDM o despliégalo mediante script como parte de tu proceso de instalación.

Una vez desplegado, la Accesibilidad y el Acceso total al disco se conceden automáticamente. Los usuarios finales pueden aprobar el aviso de Grabación de pantalla sin credenciales de administrador.


Exclusiones de AV/EDR

Algunas herramientas antivirus y EDR marcan Level como una amenaza. Añade Level a tus exclusiones antes de desplegarlo para evitar que la instalación sea bloqueada o que el agente sea puesto en cuarentena tras la instalación.

Para conocer las rutas de exclusión, los detalles del certificado y las instrucciones específicas por herramienta, consulta Detecciones falsas de AV/EDR. Level también publica un desglose de por qué las herramientas EDR marcan los agentes RMM en level.io/blog/edrs-distrust-rmms-and-thats-ok.


Requisitos del sistema

Requisito

Detalles

SO

macOS 11 (Big Sur) o posterior

Arquitectura

Intel (x64) y Apple Silicon (ARM64)

⚠️ ADVERTENCIA: macOS High Sierra, Mojave y Catalina dejarán de ser compatibles a partir del 4 de mayo de 2026.

Ubicaciones de almacenamiento

Ruta

Propósito

/Applications/Level.app/Contents/MacOS/level

Binario de la aplicación

/usr/local/bin/level

Binario de CLI

/var/lib/level

Datos del agente

/Library/LaunchAgents/io.level.srv.plist

Agente de inicio

/Library/LaunchDaemons/Level.plist

Demonio de inicio


Después de la instalación

El dispositivo aparece en tu Listado de dispositivos en 5–10 segundos y comienza a completar el inventario de hardware en pocos minutos.

Si el dispositivo no aparece o se desconecta poco después de la instalación, consulta Solución de problemas sin conexión.


Preguntas frecuentes

  • ¿Qué permisos necesita Level en macOS y por qué? Level requiere Grabación de pantalla (para control remoto), Accesibilidad (para la automatización de entrada durante sesiones remotas) y Acceso total al disco (para operaciones de archivos y gestión de parches). Sin estos permisos, el control remoto y algunas funciones de gestión no funcionarán.

  • ¿Por qué se me piden credenciales de administrador después de que finalice la instalación en mi Mac con Apple Silicon? Level crea una cuenta de servicio en dispositivos Apple Silicon para admitir la gestión de parches. Este aviso es esperado — introduce las credenciales de administrador para completar la configuración.

  • ¿Qué arquitectura debo seleccionar en la pestaña Instalador? Selecciona x64 para Macs Intel y ARM64 para Apple Silicon (M1/M2/M3). Si no estás seguro, consulta Menú Apple → Acerca de este Mac. El método de comando de una línea gestiona la detección de arquitectura automáticamente y no requiere que elijas.

  • ¿Cuál es la diferencia entre el instalador GUI y el comando de terminal? Ambos instalan el mismo agente desde el mismo PKG. El asistente GUI solicita la clave de instalación como parte del flujo de configuración. El comando de terminal (sudo installer -pkg ...) ejecuta el paquete de forma no interactiva y pasa la clave de instalación en línea — más adecuado para despliegues mediante script o remotos.

  • ¿Puedo suprimir los avisos de permisos al desplegar en muchos Macs? Parcialmente. Despliega el perfil mobileconfig PPPC de Level mediante MDM — concede silenciosamente Accesibilidad y Acceso total al disco. La Grabación de pantalla es un permiso de privacidad protegido de Apple que MDM no puede conceder silenciosamente, pero el perfil permite que los usuarios sin privilegios de administrador aprueben ese aviso ellos mismos sin necesitar credenciales de administrador.

  • ¿Puedo enviar a los usuarios finales un enlace por correo electrónico para que instalen el agente ellos mismos? No. El agente requiere derechos de administrador local, que la mayoría de los usuarios finales no tienen. La instalación debe ser realizada por alguien con acceso de administrador local, de forma manual o mediante una herramienta de despliegue.

  • ¿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 añada dispositivos a tu cuenta. Contacta con el soporte de Level para rotar la clave si es necesario.

  • El dispositivo se instaló pero no aparece en Level — ¿qué ocurre? Espera 10–15 segundos y actualiza la página. Si sigue sin aparecer, verifica que se hayan concedido los tres permisos de macOS y que una herramienta AV/EDR no haya bloqueado el agente. Consulta Detecciones falsas de AV/EDR y Solución de problemas sin conexión.

¿Ha quedado contestada tu pregunta?