Uninstall the .NET agent

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)

Requires Administrator rights in your Windows admin group.

This procedure assumes you installed the .NET agent with the MSI installer:

  1. To shut down any running agents, stop IIS. If you don't stop IIS, you may need to reboot after uninstalling the agent.
  2. Select Start > All Programs > New Relic .NET Agent > Uninstall the .NET agent.
  3. Follow the prompts to complete uninstallation.
  4. 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.

  1. From Control Panel > Programs > Programs and Features, right-click and delete any files named New Relic .NET Agent.
  2. Delete the entire folder at C:\ProgramData\New Relic\.NET Agent.
  3. Delete the entire folder at C:\Program Files\New Relic\.NET Agent.
  4. Delete the entire folder at C:\Program Files (x86)\New Relic\.NET Agent.
  5. Remove your app from the New Relic APM UI.

Uninstall the .NET agent (Linux)

To uninstall the .NET agent on Linux, use your package management tool.

You must restart your application once the uninstall is finished.

Uninstall with apt (Debian, Ubuntu, and Linux Mint)

Execute the following command as root:

sudo apt-get remove newrelic-netcore20-agent
Uninstall with dpkg (Debian, Ubuntu, and Linux Mint)

Execute the following command as root:

sudo dpkg --remove newrelic-netcore20-agent
Uninstall with yum (CentOS, Red Hat Enterprise Linux, Oracle Linux)

Execute the following command as root:

sudo yum remove newrelic-netcore20-agent
Uninstall with rpm (CentOS, Red Hat Enterprise Linux, Oracle Linux)

Execute the following command as root:

sudo rpm -e newrelic-netcore20-agent
Uninstall tarball
  1. Delete all New Relic files from your app folder.
  2. Unset New Relic environment variables:

    CORECLR_ENABLE_PROFILING=1
    CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
    CORECLR_NEWRELIC_HOME=PATH_TO_INSTALL
    CORECLR_PROFILER_PATH=%CORECLR_NEWRELIC_HOME%\NewRelic.Profiler.dll
    

For more help

Recommendations for learning more: