Inicio / Instalar en macOS

Instala el agente de Pling en macOS

El agente del host de Pling se ejecuta en tu Mac, transmite métricas de CPU, memoria, disco y red a la app de iOS, retransmite sesiones SSH/Mosh compartidas, ejecuta comandos programados y expone una pequeña interfaz web local. macOS 12 y posteriores, nativo en Apple silicon e Intel.

App de la barra de menús (recomendado)

La forma más sencilla en un Mac personal: una app de barra de menús firmada y notarizada que ejecuta el agente por ti y se actualiza automáticamente mediante Sparkle. Descarga la imagen de disco, arrastra Pling Agent a Aplicaciones, ábrela y pega tu token. Requiere macOS Sequoia (15) o posterior.

Descargar Pling Agent (.dmg)

O instálalo con Homebrew:

brew install --cask jeramo/pling/pling-agent

Homebrew (línea de comandos)

Para un Mac sin pantalla o un servidor, instala el agente de línea de comandos y luego configura tu token de API. set-token escribe la configuración e inicia el servicio de brew.

brew install jeramo/pling/pling
pling set-token <YOUR_TOKEN>

Verifica que se está ejecutando:

pling status
brew services list | grep pling

Una sola línea con curl

Omite Homebrew por completo. El instalador descarga el binario firmado y certificado más reciente, solicita tu token y registra un LaunchAgent por usuario.

curl -sSL https://raw.githubusercontent.com/Jeramo/pling-agent/main/install.sh | sh

El LaunchAgent se inicia automáticamente al iniciar sesión. Los registros se guardan en ~/Library/Logs/pling-agent.log.

Instalación manual

Elige esto cuando quieras control total o instalar en un Mac sin privilegios de administrador. Reemplaza arm64 por amd64 en los Mac con Intel.

curl -L -o pling \
  https://github.com/Jeramo/pling-agent/releases/latest/download/pling-darwin-arm64
chmod +x pling
sudo mv pling /usr/local/bin/
pling set-token <YOUR_TOKEN>

Configurar

Imprime la ruta de configuración activa:

pling config

Edítalo en $EDITOR:

pling config edit

Campos típicos: api_url, token, metrics_interval.

Actualizar

Homebrew:

brew upgrade pling
brew services restart pling

Instalación con curl: vuelve a ejecutar el script de instalación. Reemplaza el binario y reinicia el LaunchAgent.

Desinstalar

pling uninstall

Elimina el binario, la configuración y el registro del servicio. Las instalaciones con Homebrew también se pueden eliminar con brew uninstall pling.

Preguntas frecuentes

¿El agente de Pling funciona en Apple silicon?

Sí. Los binarios nativos arm64 se distribuyen junto con las compilaciones Intel x86_64. El instalador y el tap de Homebrew eligen la arquitectura correcta automáticamente.

¿Los binarios de macOS están notarizados?

Sí. Cada versión está firmada con Developer ID y notarizada por Apple, así que Gatekeeper no bloquea el binario.

¿Dónde está el archivo de configuración de macOS?

Cuando se instala mediante Homebrew, la configuración se encuentra en $(brew --prefix)/etc/pling/config.toml. El instalador de curl escribe /etc/pling/config.toml. Ejecuta pling config para mostrar la ruta activa en esta máquina.

¿Cómo veo los registros del agente?

Ejecuta pling logs -f para ver los registros en tiempo real. Las instalaciones con Homebrew pasan por brew services; las instalaciones con LaunchAgent escriben en ~/Library/Logs/pling-agent.log.

¿Cómo actualizo el agente de Pling?

Homebrew: brew upgrade pling && brew services restart pling. Instalación con curl: vuelve a ejecutar el script de instalación; reemplaza el binario y reinicia el LaunchAgent.

¿Instalando en otra plataforma? Linux · Windows