Tutorial

Uninstall a server agent

Remove an agent cleanly from a host and detach it from the dashboard.

1) Pause the agent in the dashboard

  1. Open Dashboard → Server agents and select the target host.
  2. Pause monitoring to stop alerts during removal.

2) Stop and remove on the host

  1. SSH into the server.
  2. Stop the service: sudo systemctl stop uptime-server-agent-go.service.
  3. Remove the install directory (where you ran the installer). Example: sudo rm -rf /opt/uptime-agent.
  4. Delete the service file: sudo rm /etc/systemd/system/uptime-server-agent-go.service, then sudo systemctl daemon-reload.

If you installed under a different path or init system, remove the equivalent files there.

3) Clean up the dashboard entry

  • Back in Server agents, mark the host as removed or delete it.
  • Confirm it disappears from server health summaries and no new heartbeats arrive.