Manage Agents

In the Agents tab, you'll see all the agents in your subscription and their status. Keep in mind your agents are centrally managed by our cloud platform.

How do I install agents? Our wizard will help you do this quickly! You'll create an activation key, download the agent installer and run the installer on each host. Ready to get started? Go to Agents and click the Install New Agent button.

How do I apply tags to agents? You can apply tags to agents in the Cloud Agent app or the Asset View app. By default, all agents are assigned the Cloud Agent tag. You can add more tags to your agents if required. Learn more

Find where your agent assets are located! We’re now tracking geolocation of your assets using public IPs. Asset Geolocation is enabled by default for US based customers. Learn more

Be sure to activate agents for vulnerability scanning, compliance scanning, or both. Once activated you can deactivate at any time. Your options will depend on your account settings. Tell me the steps

Once agents are installed successfully you'll see inventory data such as IP address, OS, hostnames within a few minutes. Each agent collects data for the baseline snapshot and uploads it to the cloud platform. After this agents upload deltas only. Learn more

Agents have a default configuration that controls agent behavior. You can customize the various configuration settings. Learn more

Agents are self-updating When a new agent version is available, the agent downloads and installs it automatically. No reboot is required. The timing of updates depends on performance settings in the agent's configuration profile. Want to delay upgrading agent versions? Click here

Uninstall Agent This option removes the agent from the UI and your subscription. You can choose this option from Quick Actions menu to uninstall a single agent, or from the Actions menu to uninstall multiple agents in one go. Once uninstalled the agent no longer syncs asset data to the cloud platform. You can reinstall an agent at any time using the same activation key or another one you choose.

Uninstalling the Agent from the Cloud Agent UI or API

Uninstalling the Agent from the host itself

Self-Protection feature The self-protection feature helps to prevent non-trusted processes to make unwanted changes to Qualys Cloud Agent. To enable the feature, contact your Qualys representative.

You can disable the self-protection feature if you want to access the agent data and artifacts required by debugging, such as log files. You can generate a key to disable the self-protection feature for an agent. Learn more

Want to remove an agent host from your subscription? Just uninstall the agent as described above.

Run on-demand scan: You can run on-demand scan in addition to the defined interval scans. This provides flexibility to launch scan without waiting for the next interval scan. Learn more

Don't see any agents? The Agents tab shows you agents that have registered with the cloud platform. Once installed, agents connect to the cloud platform and register themselves right away. Click here to troubleshoot.

Agent Permissions Managers are granted all Agent Permissions by default. You might want to grant subusers these permissions. Learn more

Agent Installation

Agent Platform Availability

Download User Guide (PDF) Windows | Linux | BSD | Unix | MacOS

Steps for Proxy configuration

Windows | Linux/BSD/Unix | MacOS

Quick Links

Get Started

View Asset Details

Agent Status

Asset Geolocation

Bulk Actions

Duplicate agent ID detection

Manage Tags


Common How Tos

How To Search

Download agent list

Suspend Scanning

Prevent auto updating

Uninstall Agent

Did you Know? You can choose the columns you'd like to see in your agents list. Go to the Tools menu (above the list) and select Columns.

Tip Looking for agents that have connected, not connected within N days? Use the search filters above your agents list.