Uninstalling Miniconda
Back up environments
If you plan to reinstall Miniconda, back up your environments before uninstalling by exporting them to a YAML file using the following command:
You can then use this file to recreate the environment after reinstalling. For more information, see Creating an environment.
Uninstall procedure
Follow the uninstall procedure below for your operating system:
(Optional) If you have created any environments outside your miniconda3 directory, Anaconda recommends manually deleting them to increase available disc space on your computer. This step must be performed before uninstalling Miniconda.
Uninstall environments outside the miniconda3 directory
Uninstall environments outside the miniconda3 directory
-
Open Anaconda Prompt.
-
View a list of all your environments by running the following command:
If you have any environments in a directory other than
miniconda3, you will need to uninstall the directory that contains the environments. Uninstalling the directory with the following command deletes the environments’ contents and them from your user files. -
Open your preferred shell.
-
Uninstall the directory by running the following command:
- Search for “Control Panel” in the taskbar search and select the Control Panel app.
- Click Uninstall a program under Programs.
- Select Anaconda from the list of programs.
- Click Uninstall.
- Follow the on-screen instructions to complete the uninstallation process.
- Verify your uninstall was successful by searching for “Anaconda Prompt” in the taskbar search. It should no longer appear.
- Search for “Control Panel” in the taskbar search and select the Control Panel app.
- Click Uninstall a program under Programs.
- Select Anaconda from the list of programs.
- Click Uninstall.
- Follow the on-screen instructions to complete the uninstallation process.
- Verify your uninstall was successful by searching for “Anaconda Prompt” in the taskbar search. It should no longer appear.
On Windows operating systems, you can silently uninstall Miniconda using either Command Prompt or PowerShell.
Open a new Command Prompt window and run the following command:
As of Miniconda v24.11.1, you can also use additional arguments to remove other files from your system.
Optional uninstall arguments
Optional uninstall arguments
These arguments are not recommended if you have multiple conda installations.
| Argument | Values | Description |
|---|---|---|
/RemoveCaches= |
| Removes caches (such as package and index caches, among others). |
/RemoveConfigFiles= |
| Removes configuration files such as .condarc files. user removes the files inside the current user’s home directory and system removes files outside of that directory. |
/RemoveUserData= |
| Removes user data, such as the %USERPROFILE%/.conda directory. |
Open a new Command Prompt window and run the following command:
As of Miniconda v24.11.1, you can also use additional arguments to remove other files from your system.
Optional uninstall arguments
Optional uninstall arguments
These arguments are not recommended if you have multiple conda installations.
| Argument | Values | Description |
|---|---|---|
/RemoveCaches= |
| Removes caches (such as package and index caches, among others). |
/RemoveConfigFiles= |
| Removes configuration files such as .condarc files. user removes the files inside the current user’s home directory and system removes files outside of that directory. |
/RemoveUserData= |
| Removes user data, such as the %USERPROFILE%/.conda directory. |
Open a new PowerShell window and run the following command:
As of Miniconda v24.11.1, you can also use additional arguments to remove other files from your system.
Optional uninstall arguments
Optional uninstall arguments
These arguments are not recommended if you have multiple conda installations.
| Argument | Values | Description |
|---|---|---|
/RemoveCaches= |
| Removes caches (such as package and index caches, among others). |
/RemoveConfigFiles= |
| Removes configuration files such as .condarc files. user removes the files inside the current user’s home directory and system removes files outside of that directory. |
/RemoveUserData= |
| Removes user data, such as such as the ${env:USERPROFILE}/.conda directory. |
Verify your uninstall was successful by searching for “Anaconda Prompt” in the taskbar search. It should no longer appear.
(Optional) If you have created any environments outside your miniconda3 directory, Anaconda recommends manually deleting them to increase available disc space on your computer. This step must be performed before uninstalling Miniconda.
Uninstall environments outside the miniconda3 directory
Uninstall environments outside the miniconda3 directory
-
Open Anaconda Prompt.
-
View a list of all your environments by running the following command:
If you have any environments in a directory other than
miniconda3, you will need to uninstall the directory that contains the environments. Uninstalling the directory with the following command deletes the environments’ contents and them from your user files. -
Open your preferred shell.
-
Uninstall the directory by running the following command:
- Search for “Control Panel” in the taskbar search and select the Control Panel app.
- Click Uninstall a program under Programs.
- Select Anaconda from the list of programs.
- Click Uninstall.
- Follow the on-screen instructions to complete the uninstallation process.
- Verify your uninstall was successful by searching for “Anaconda Prompt” in the taskbar search. It should no longer appear.
- Search for “Control Panel” in the taskbar search and select the Control Panel app.
- Click Uninstall a program under Programs.
- Select Anaconda from the list of programs.
- Click Uninstall.
- Follow the on-screen instructions to complete the uninstallation process.
- Verify your uninstall was successful by searching for “Anaconda Prompt” in the taskbar search. It should no longer appear.
On Windows operating systems, you can silently uninstall Miniconda using either Command Prompt or PowerShell.
Open a new Command Prompt window and run the following command:
As of Miniconda v24.11.1, you can also use additional arguments to remove other files from your system.
Optional uninstall arguments
Optional uninstall arguments
These arguments are not recommended if you have multiple conda installations.
| Argument | Values | Description |
|---|---|---|
/RemoveCaches= |
| Removes caches (such as package and index caches, among others). |
/RemoveConfigFiles= |
| Removes configuration files such as .condarc files. user removes the files inside the current user’s home directory and system removes files outside of that directory. |
/RemoveUserData= |
| Removes user data, such as the %USERPROFILE%/.conda directory. |
Open a new Command Prompt window and run the following command:
As of Miniconda v24.11.1, you can also use additional arguments to remove other files from your system.
Optional uninstall arguments
Optional uninstall arguments
These arguments are not recommended if you have multiple conda installations.
| Argument | Values | Description |
|---|---|---|
/RemoveCaches= |
| Removes caches (such as package and index caches, among others). |
/RemoveConfigFiles= |
| Removes configuration files such as .condarc files. user removes the files inside the current user’s home directory and system removes files outside of that directory. |
/RemoveUserData= |
| Removes user data, such as the %USERPROFILE%/.conda directory. |
Open a new PowerShell window and run the following command:
As of Miniconda v24.11.1, you can also use additional arguments to remove other files from your system.
Optional uninstall arguments
Optional uninstall arguments
These arguments are not recommended if you have multiple conda installations.
| Argument | Values | Description |
|---|---|---|
/RemoveCaches= |
| Removes caches (such as package and index caches, among others). |
/RemoveConfigFiles= |
| Removes configuration files such as .condarc files. user removes the files inside the current user’s home directory and system removes files outside of that directory. |
/RemoveUserData= |
| Removes user data, such as such as the ${env:USERPROFILE}/.conda directory. |
Verify your uninstall was successful by searching for “Anaconda Prompt” in the taskbar search. It should no longer appear.
(Optional) If you have created any environments outside your miniconda3 directory, Anaconda recommends manually deleting them to increase available disc space on your computer. This step must be performed before uninstalling Miniconda.
Uninstall environments outside the miniconda3 directory
Uninstall environments outside the miniconda3 directory
-
View a list of all your environments by running the following command:
If you have any environments in a directory other than
miniconda3, you need to uninstall the directory that contains the environments. a. -
Uninstall the directory by running the following command:
-
Open a new terminal application window.
-
Deactivate your
(base)environment by running the following command:You should no longer see
(base)in your terminal prompt. -
As of Miniconda v24.11.1, an
uninstaller.shscript is available to help you remove Miniconda from your system. Run the basic script to remove Miniconda and its shell initializations, or add arguments to remove additional user or system files. If your version does not have the uninstaller script, use the instructions under Manual uninstall.If you have installed Miniconda into a system location, you must use
sudo -Eto run the uninstaller.For example, the
.pkginstaller for macOS installs Miniconda into a system location,/opt/miniconda3.Including additional uninstall arguments is optional. These arguments remove additional files from your system.
If any files outside the installation directory are symlinks, it’s possible that only the link will be removed, not the underlying files, meaning you’ll need to find and delete them manually.
These arguments are not recommended if you have multiple conda installations.
Optional uninstall arguments
Argument Values Description --remove-cachesRemoves caches (such as package and index caches, among others). --remove-config-filesusersystemall
Removes configuration files such as .condarcfiles.userremoves the files inside the current user’s home directory andsystemremoves all files outside of that directory.--remove-user-dataRemoves user data, such as the ~/.condadirectory.Example uninstall command with optional arguments-
(Optional) Remove any conda initialization scripts from all your terminal shell profiles by running the following command:
-
Remove your entire
miniconda3directory withrm -rf. Depending on your installation, this directory will be in your root folder or in your opt folder.When paired with the
-r(recursive) flag, thef(force) flag deletes all specified directories and the files within them without prompting you for confirmation. Double-check and verify that you have correctly specified the directories you intend to delete before runningrm -rf, as this action can’t be undone.Example commands for deleting your miniconda3 folder -
(Optional) Remove the hidden
.condarcfile and.condaand.continuumdirectories from your home directory by running the following command:Keep your
.condarcfile if you have custom configurations for conda and plan to reinstall.
-
Close and reopen your terminal to refresh it. You should no longer see
(base)in your terminal prompt.