Uninstalling the Agent

Remove the MaxRMM agent from an endpoint using the built-in uninstall command or manual cleanup.

Clean Uninstall (Recommended)

Open an elevated PowerShell window and run:

& "C:\Program Files\MaxRMM\maxrmm-agent.exe" --uninstall

This command will:

  1. Stop the MaxRMM Agent Windows service
  2. Remove the service registration
  3. Delete the agent registry keys from HKLM\SOFTWARE\MaxRMM\Agent
  4. Remove the install directory C:\Program Files\MaxRMM\

After uninstalling, the agent will appear as "offline" in the dashboard within 60 seconds.

Silent Uninstall

For automated removal (e.g., via GPO or MDM):

& "C:\Program Files\MaxRMM\maxrmm-agent.exe" --uninstall --silent

Exit code 0 indicates success.

Manual Cleanup

If the uninstall command fails or you need to manually remove remnants:

1. Stop and remove the service

Stop-Service "MaxRMM Agent" -Force -ErrorAction SilentlyContinue
sc.exe delete "MaxRMM Agent"

2. Remove the install directory

Remove-Item -Path "C:\Program Files\MaxRMM" -Recurse -Force

3. Remove registry keys

Remove-Item -Path "HKLM:\SOFTWARE\MaxRMM" -Recurse -Force

4. (Optional) Remove from dashboard

The agent entry will remain in the dashboard with an "offline" status. You can delete it from the dashboard if you do not want to see it anymore. This does not affect the endpoint — it only removes the record from your MaxRMM tenant.

Note: Removing an agent from the dashboard is permanent. You cannot undo this action. If you reinstall the agent on the same machine later, it will register as a new device with a new agent ID.

Remote Uninstall

You can uninstall the agent remotely from the dashboard:

  1. Navigate to Agents and select the agent
  2. Open the Terminal tab
  3. Run: & "C:\Program Files\MaxRMM\maxrmm-agent.exe" --uninstall

The agent will disconnect immediately after the uninstall command completes.