Tutorial

Update a server agent

Keep agents current with the latest fixes. This guide covers rolling upgrades with minimal downtime.

1) Check the current version

  • Open Dashboard → Server agents and select the host.
  • Note the reported agent version in the details panel.
  • Compare with the latest version noted in release notes or the install dialog.

2) Run the update on the host

  1. If auto-update is enabled, the agent will upgrade itself automatically once a new release is available.
  2. SSH into the server where the agent is installed.
  3. Re-run the current install command from the dashboard (it includes the latest build URL).
  4. When prompted, confirm the action; the script will download and replace the agent binary.
  5. It warns if you are not using sudo; run with elevated rights to restart the service cleanly.

Rolling updates: update one host at a time to keep coverage while agents recycle.

3) Confirm healthy after upgrade

  • Return to Server agents and check that the version badge shows the new release.
  • Ensure heartbeats are updating and CPU/memory data flows within a minute.
  • If status remains unknown, restart the agent service on the host and verify outbound connectivity.