• /
  • Log in

Uninstall the infrastructure agent

Your hosts are added automatically when you install the infrastructure agent for your Linux or Windows operating system, or update the agent. Similarly, your hosts disappear automatically when you uninstall the agent. You do not need to manually add or remove your hosts.

Uninstalling the agent does not directly affect any of your integrations. To uninstall an integration, see Uninstall integrations.

Uninstall the Linux infrastructure agent

If you used the default install procedure for your infrastructure agent for Linux environments, use your package management tools to uninstall it. You do not need to stop the service before running the uninstall command.

If you followed an assisted or manual installation process, you need to manually delete all the files created when you unpacked the agent file.

Important

Since there are are no automated scripts, old files may remain when you uninstall. Be sure to manually remove outdated files.

Uninstall the Windows Server icon Windows infrastructure agent

Tip

Requires Administrator rights in your Windows admin group.

If you used the default install procedure for the infrastructure agent for Windows environments, to uninstall:

  1. Stop the infrastructure agent.
  2. From the Windows Control Panel, use the Add/Remove Programs and Features tool to uninstall the infrastructure agent.
  3. From the Windows Program Files, manually delete the New Relic folder to delete all files associated with the infrastructure agent for Windows.

If you followed an assisted or manual installation process, you need to manually delete all the files created when you unpacked the agent file.

Important

Since there are are no automated scripts, old files may remain when you uninstall. Be sure to manually remove outdated files.

Uninstall the macOS icon macOS infrastructure agent

If you used the default install procedure for the infrastructure agent for macOS environments, to uninstall:

  1. Stop the infrastructure agent:

    brew services stop newrelic-infra-agent
  2. From the terminal, run the uninstall command:

    brew uninstall newrelic-infra-agent

Uninstall using config management tools

To uninstall the infrastructure agent if you used a configuration management tool:

Config management tools

Uninstall New Relic infrastructure agent

Ansible

Set the 'agent_state' parameter to 'absent'

Chef

Set the 'agent_action' node to uninstall

AWS Elastic Beanstalk

Remove newrelic.config from .ebextensions, then deploy.

Puppet

Set the 'ensure' parameter to 'absent'

Optional: Purge remaining files

If you use standard package management tools for your selected platform, the uninstall process typically leaves configuration and other miscellaneous files. If you need to completely purge any of the remaining files after uninstalling the New Relic infrastructure agent, follow standard procedures for your operating system.

For more help

If you need more help, check out these support and learning resources:

Create issueEdit page
Copyright © 2021 New Relic Inc.