Inicio / Instalar en Windows
Instala el agente de Pling en Windows
El agente del host de Pling se ejecuta en Windows 10, Windows 11 y Windows Server. Transmite métricas de CPU, memoria, disco y red a la app de iOS, ejecuta comandos programados y expone una pequeña interfaz web local. Instálalo una vez con PowerShell y se inicia automáticamente como un servicio de Windows.
Instalador de PowerShell (recomendado)
Abre PowerShell como administrador y luego ejecuta:
irm https://raw.githubusercontent.com/Jeramo/pling-agent/main/install.ps1 | iexEl instalador descarga el binario más reciente, registra un servicio de Windows y añade el directorio de instalación al PATH del sistema para que pling funcione en cualquier shell. Cuando se te solicite, pega tu token de API.
pling set-token <YOUR_TOKEN>
pling statuspling set-token afterwards).Instalación manual
Descarga el binario, colócalo en algún lugar del PATH y escribe un archivo de configuración.
Invoke-WebRequest `
-Uri https://github.com/Jeramo/pling-agent/releases/latest/download/pling-windows-amd64.exe `
-OutFile pling.exe
Move-Item pling.exe C:\Windows\System32\pling.exe
New-Item -ItemType Directory -Force C:\ProgramData\Pling | Out-Null
@'
api_url = "https://agent.plingpush.com"
token = "YOUR_TOKEN_HERE"
metrics_interval = 60
'@ | Set-Content C:\ProgramData\Pling\config.toml -Encoding utf8Ejecútalo de forma interactiva para confirmar:
pling serveConfigurar
Edita la configuración en tu editor predeterminado:
pling config editO actualiza solo el token:
pling set-token <NEW_TOKEN>Actualizar
Vuelve a ejecutar el instalador de PowerShell. Reemplaza el binario, conserva tu configuración y reinicia el servicio:
irm https://raw.githubusercontent.com/Jeramo/pling-agent/main/install.ps1 | iexDesinstalar
pling uninstallElimina el binario, la configuración, la entrada del PATH y el servicio de Windows.
Preguntas frecuentes
¿Qué versiones de Windows son compatibles?
Windows 10 y Windows 11, amd64. Windows Server 2019 y 2022 también funcionan. Windows en ARM64 aún no se distribuye de forma nativa. Usa la instalación manual con la capa de emulación de 64 bits si es necesario.
¿Necesito cambiar mi política de ejecución de PowerShell?
No. El comando de una sola línea irm | iex canaliza el script hacia PowerShell en el mismo proceso, así que la política de ejecución no lo bloquea. Si guardas primero el script de instalación en disco, puede que necesites Set-ExecutionPolicy -Scope Process Bypass para ejecutarlo.
¿Dónde está el archivo de configuración de Windows?
La ruta de configuración predeterminada es C:\ProgramData\Pling\config.toml. Ejecuta pling config para imprimir la ruta activa en esta máquina.
¿Cómo se almacenan los registros de Windows?
Ejecuta pling logs -f para verlos en tiempo real. El servicio de Windows también escribe en el Registro de eventos de Windows y en un archivo rotativo en C:\ProgramData\Pling\logs\agent.log.
¿Pling funciona en cmd.exe y Git Bash?
Sí. El instalador de PowerShell añade el directorio de instalación al PATH del sistema, de modo que pling se puede invocar desde cmd.exe, Git Bash, Windows Terminal y cualquier otra shell.