Uninstall the Agent from the Cloud Agent UI or API

When you uninstall a Cloud Agent using the Cloud Agent app user interface or Cloud Agent API, the agent and license is removed from the Qualys subscription. We’ll also purge the associated Cloud Agent host record and scan results for any licensed apps, i.e. Vulnerability Management, Policy Compliance. Host records with merged asset views (i.e. scans results from Cloud Agent and scanner) are purged until the next successful scanner job). Note agent registry data is not removed from Windows hosts.

How to Uninstall a Single Cloud Agent

Hover over the agent of interest and select Uninstall Agent from the Quick Actions menu.

Quick actions - Uninstall Agent option for an asset.

Once you uninstall an agent, it cannot be reversed. The Confirmation dialog box displays the impact of uninstallation and the number of agents that are being removed.

uninstall confirmation dialog box

Note: On MacOS High Sierra (10.13), launched takes some time to remove the com.qualys.cloud-agent process, although the agent is already uninstalled.

How to Uninstall Multiple Cloud Agents

Select the checkbox next to agents of interest and choose Uninstall Agent from the Actions menu.

Actions Menu - Uninstall Agent option to uninstall multiple agents.

If you select the agents for uninstallation in bulk by using the QQL query— tags.name: Cloud Agent or tracking method as QAGENT, the following error message is displayed.

warning bulk uninstallation

In this case, the Cloud Agents are not uninstalled. You can add more filters to search for the Cloud Agents you want to uninstall and prevent unintentional uninstallation of Cloud Agents when selected in bulk.

Looking for something else?

Uninstalling the Agent from the host itself

How to uninstall Windows Agent from the command line

Purge Rule Behavior