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 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:
- Stop the infrastructure agent.
- From the Windows Control Panel, use the Add/Remove Programs and Features tool to uninstall the infrastructure agent.
- 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 infrastructure agent
If you used the default install procedure for the infrastructure agent for macOS environments, to uninstall:
Stop the infrastructure agent:
brew services stop newrelic-infra-agentFrom 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 |
---|---|
Set the | |
Set the | |
Remove | |
Set the |
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:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's and and documentation.