Uninstalling AppMap

AppMap consists of several components, each of which may require a different uninstall approach depending on what changes were made to your applications during installation.

Uninstalling AppMap IDE Plugins

Uninstalling the AppMap VS Code Extension

To uninstall AppMap from VS Code, first select the Extensions control to view your installed extensions.

Next, find and select AppMap in the list of installed extensions. Then click the Uninstall button to remove the AppMap extension from your editor.

Finally, if your project supports AppMap Launch Configurations, you can now remove the AppMap specific details in the .vscode/launch.json and the .vscode/settings.json files.

Please note that even after uninstalling the IDE extension, your project may still be configured to load an AppMap library and continue to record maps when your application is run. You should follow the language-specific uninstall instructions below to remove the AppMap library from your project.

Uninstalling the AppMap JetBrains Plugin

To uninstall AppMap from JetBrains editors like IntelliJ and PyCharm, open your editor’s Settings panel from the main menu. Select Plugins on the left panel, then find and select AppMap in the list of installed plugins. Then click the Uninstall button to remove the AppMap extension from your editor.

Please note that even after uninstalling the IDE plugin, your project may still be configured to load an AppMap library and continue to record maps when your application is run. You should follow the language-specific uninstall instructions below to remove the AppMap library from your project.

Removing AppMap libraries from your application

Removing AppMap from your application typically involves removing the AppMap library from your project’s dependencies. Language-specific instructions on how to do this are below.

Ruby

Use the bundle command to remove the AppMap library from your project:

$ bundle remove appmap

Or you can remove the appmap gem globally if installed at the system level.

$ gem uninstall appmap

Alternatively, manually remove the line containing appmap from the top of your Gemfile.

Java

For IntelliJ users, the act of uninstalling the AppMap plugin from the IDE is enough to fully remove AppMap configuration from your project.

VS Code users should remove the AppMap launch commands from the files launch.json and settings.json, both located in the .vscode folder.

If you had also installed the AppMap Maven plugin, you should remove the appropriate AppMap <plugin> definition from your pom.xml. Similarly, if you had installed the AppMap Gradle plugin, you should remove the AppMap plugins section from your build.gradle or build.gradle.kts file.

Python

Remove AppMap using your Python dependency manager:

Using pip:
$ pip uninstall appmap

Using poetry:
$ poetry remove appmap

Using pipenv:
$ pipenv uninstall appmap

Also, if your project contains a requirements.txt file, you should remove appmap from that file too.

Node.js

Your Node project dependencies were not modified to use AppMap. Simply changing your application’s launch command to no longer prepend npx appmap-node is enough to stop using AppMap.

Removing AppMap-generated files from your project

If you had generated AppMap Data, you will have a number of files in your project folder that can safely be removed after completing the uninstall steps above. This is an optional step.

Start by removing the AppMap configuration file:

$ rm appmap.yml

Finally, remove any generated AppMap files from your project:

$ rm -r tmp/appmap

Removing Temporary AppMap Local Working Directories

When installing the AppMap Extension for VS Code or JetBrains, AppMap will create a $HOME/.appmap folder to store downloaded CLI binaries, jar files, local Navie chat history, and any other data necessary for AppMap to operate.

After you uninstall the AppMap extension for your code editor, you can safely delete the $HOME/.appmap directory and all the data within.

Was this page helpful? thumb_up Yes thumb_down No
Thank you for your feedback!