Home / Install on Windows

Install the Pling agent on Windows

The Pling host agent runs on Windows 10, Windows 11, and Windows Server. It streams CPU, memory, disk, and network metrics to the iOS app, runs scheduled commands, and exposes a small local web UI. Install once with PowerShell and it autostarts as a Windows service.

PowerShell installer (recommended)

Open PowerShell as Administrator, then run:

irm https://raw.githubusercontent.com/Jeramo/pling-agent/main/install.ps1 | iex

The installer downloads the latest binary, registers a Windows service, and adds the install dir to the system PATH so pling works in any shell. When prompted, paste your API token.

pling set-token <YOUR_TOKEN>
pling status

Where to find your token: open the iOS app, go to Settings → Hosts → Add agent. Copy the token and paste it when the installer asks (or run pling set-token afterwards).

Manual install

Download the binary, drop it somewhere on PATH, and write a config file.

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 utf8

Run interactively to confirm:

pling serve

Configure

Edit the config in your default editor:

pling config edit

Or update just the token:

pling set-token <NEW_TOKEN>

Update

Re-run the PowerShell installer. It replaces the binary, keeps your config, and restarts the service:

irm https://raw.githubusercontent.com/Jeramo/pling-agent/main/install.ps1 | iex

Uninstall

pling uninstall

Removes the binary, config, PATH entry, and Windows service.

Frequently asked

Which Windows versions are supported?

Windows 10 and Windows 11, amd64. Windows Server 2019 and 2022 also work. ARM64 Windows is not yet shipped natively — use the manual install with the 64-bit emulation layer if needed.

Do I need to change my PowerShell execution policy?

No. The irm | iex one-liner pipes the script into PowerShell in-process, so the execution policy does not block it. If you save the install script to disk first, you may need Set-ExecutionPolicy -Scope Process Bypass to run it.

Where is the Windows config file?

Default config path is C:\ProgramData\Pling\config.toml. Run pling config to print the active path on this machine.

How are Windows logs stored?

Run pling logs -f to tail. The Windows service also writes to the Windows Event Log and to a rotating file at C:\ProgramData\Pling\logs\agent.log.

Does pling work in cmd.exe and Git Bash?

Yes. The PowerShell installer adds the install directory to the system PATH, so pling is callable from cmd.exe, Git Bash, Windows Terminal, and any other shell.

Installing on a different platform? macOS · Linux