This document explains how to uninstall the New Relic .NET agent. For instructions on how to temporarily disable the agent, see Disable the agent.
To uninstall the .NET agent, follow the procedure that corresponds to your operating system:
Uninstall the .NET agent (Windows)
Tip
Requires Administrator rights in your Windows admin group.
This procedure assumes you installed the .NET agent with the MSI installer:
- To shut down any running agents, stop IIS. If you don't stop IIS, you may need to reboot after uninstalling the agent.
- Select Start > All Programs > New Relic .NET Agent > Uninstall the .NET agent.
- Follow the prompts to complete uninstallation.
- Restart IIS.
After uninstalling the agent, you may want to remove all agent-related files. Be sure to check other paths to remove any other New Relic files. For example, uninstalling the .NET agent does not delete your newrelic.config
file.
- From Control Panel > Programs > Programs and Features, right-click and delete any files named
New Relic .NET Agent
. - Delete the entire folder at
C:\ProgramData\New Relic\.NET Agent
. - Delete the entire folder at
C:\Program Files\New Relic\.NET Agent
. - Delete the entire folder at
C:\Program Files (x86)\New Relic\.NET Agent
. - Remove your app from the APM UI.
Uninstall the .NET agent (Linux)
To uninstall the .NET agent on Linux, use your package management tool.
Important
For .NET agent versions 10.0.0 or higher, the name of the package is newrelic-dotnet-agent
. For .NET agent versions 9.9.0 or lower, the name of the package is newrelic-netcore20-agent
.
The rest of this document will refer to newrelic-dotnet-agent
; replace this with the older name if you have an older agent version installed.
Important
You must restart your application once the uninstall is finished.