Home / Install on macOS

Install the Pling agent on macOS

The Pling host agent runs on your Mac, streams CPU, memory, disk, and network metrics to the iOS app, relays shared SSH/Mosh sessions, runs scheduled commands, and exposes a small local web UI. macOS 12 and later, native on Apple silicon and Intel.

Homebrew (recommended)

Install the tap and the agent in one step, then set your API token. set-token writes the config and starts the brew service.

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

Verify it's running:

pling status
brew services list | grep pling
Where to find your token: open the iOS app, go to Settings → Hosts → Add agent. Copy the token and paste it into set-token.

Curl one-liner

Skip Homebrew entirely. The installer downloads the latest signed and notarized binary, prompts for your token, and registers a per-user LaunchAgent.

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

The LaunchAgent autostarts on login. Logs go to ~/Library/Logs/pling-agent.log.

Manual install

Pick this when you want full control or to install on a Mac without admin privileges. Replace arm64 with amd64 on Intel Macs.

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>

Configure

Print the active config path:

pling config

Edit it in $EDITOR:

pling config edit

Typical fields: api_url, token, metrics_interval.

Update

Homebrew:

brew upgrade pling
brew services restart pling

Curl install: re-run the install script. It replaces the binary and restarts the LaunchAgent.

Uninstall

pling uninstall

Removes the binary, config, and service registration. Homebrew installs can also be removed with brew uninstall pling.

Frequently asked

Does the Pling agent work on Apple silicon?

Yes. Native arm64 binaries are shipped alongside Intel x86_64 builds. The installer and the Homebrew tap pick the right architecture automatically.

Are macOS binaries notarized?

Yes. Every release is signed with Developer ID and notarized by Apple, so Gatekeeper does not block the binary.

Where is the macOS config file?

When installed via Homebrew the config lives at $(brew --prefix)/etc/pling/config.toml. The curl installer writes /etc/pling/config.toml. Run pling config to print the active path on this machine.

How do I view agent logs?

Run pling logs -f to tail logs. Homebrew installs route through brew services; LaunchAgent installs write to ~/Library/Logs/pling-agent.log.

How do I update the Pling agent?

Homebrew: brew upgrade pling && brew services restart pling. Curl install: re-run the install script; it replaces the binary and restarts the LaunchAgent.

Installing on a different platform? Linux · Windows