Uninstall the agent

Updated April 20, 2026

Pass --uninstall to the same installer script to remove the Hyperping agent: the service is stopped and deregistered and the binaries are removed, while configuration and state stay on disk so you can reinstall without losing the agent token. Removing the server from the dashboard or rotating its credential are separate actions.

Stop and remove

Run on the host:

TerminalBASH
curl -fsSL https://hyperping.com/install.sh | sh -s -- --uninstall
Service
Stops and disables hp-agent.service on Linux, unloads com.hyperping.agent on macOS.
Unit files
Removes /etc/systemd/system/hp-agent.service or /Library/LaunchDaemons/com.hyperping.agent.plist.
Binaries
Removes files from /usr/local/bin/ and /usr/local/libexec/.
Legacy
Cleans up 0.1.x service files if they exist.

What is kept by default

Fully remove everything

To purge all Hyperping files:

TerminalBASH
sudo rm -rf /etc/hyperping /var/lib/hyperping /var/log/hyperping

The hyperping system user on Linux is harmless, but you can remove it with sudo userdel hyperping if your compliance policy requires it.

Remove from the dashboard

Rotate the credential without uninstalling

If you only need to rotate the host's agent token, for example after suspected compromise of /etc/hyperping/agent.env, use Revoke agent from the server menu instead. The server row stays, the running binary starts 401-ing, and re-running the installer with a new install token brings the host back with a fresh credential and the same UUID (so metric history is preserved). See Re-enrollment.

Reinstall after uninstall

  1. Generate a fresh token

    Add the server again (or regenerate the install token) from the Servers view.

  2. Re-run the installer

    Paste the new install command on the host. The new token replaces any cached credential.

  3. Confirm in the dashboard

    Refresh the Servers view. The server moves back to Online within about 30 seconds.

Next steps