Just Published! Threat Report: Exposing Malware in Linux-Based Multi-Cloud Environments | Download Now

App Control: How to Uninstall an Agent From the Console

App Control: How to Uninstall an Agent From the Console


  • App Control Console: 8.x and Higher
  • App Control Agent: 8.x and Higher
  • Microsoft Windows: All Supported Versions
  • Linux: All Supported Versions


To uninstall an App Control agent using the console


  1. Login to the App Control Console
  2. Create a policy and move the devices being uninstalled to this new policy.
  3. Navigate to https://ServerName/agent_config.php
  4. Create an Agent Configuration property with the following values:
    • It is critical to apply this property correctly. Failure to do so will result in all agents immediately being uninstalled.
    • *****WARNING***** - Enabling this setting for Linux platforms and assigned to a specific policy, will be seen by the Linux agent as all policies, and begin the removal of the agents from all endpoints in all policies. Please be aware of enabling this for Linux in specific policies. This applies to any agent_config property in environments with Linux endpoints running the Carbon Black App Control agent.
    • Property Name: Uninstall Agent <Devicename>
    • Host ID: Click the "search" and select device to be uninstalled
    • Value: allow_uninstall=2
    • Create For: Selected Policies > Select Policy of Agent being uninstalled
  5. Agent will be uninstalled

Additional Notes

  • To uninstall multiple agents at once, it's recommended to create an "uninstall" policy and select the uninstall policy in the allow_uninstall=2 agent configuration.

Related Content

Labels (1)
Was this article helpful? Yes No
50% helpful (1/2)
Article Information
Creation Date: