Uninstalling Miniconda

To uninstall your Miniconda installation:

Windows

1. Search for “Control Panel” in the Windows search box and select the Control Panel app.

2. Click Uninstall a program under Programs.

3. Select Miniconda from the list of programs.

4. Click Uninstall.

5. Follow the on-screen instructions to complete the uninstallation process.

6. (Optional) If you have created any environments outside your miniconda3 directory, you can manually delete them to increase available disc space on your computer.

Silent CLI uninstall

On Windows operating systems, you can silently uninstall Miniconda using either Command Prompt or PowerShell.

Command Prompt

Open a new Command Prompt window and run the following command:

start .\miniconda3\Uninstall-Miniconda3.exe /S

As of Miniconda v24.11.1, you can also use additional arguments to remove other files from your system.

Optional uninstall arguments

/RemoveCaches=[0|1]

Removes caches such package caches.

/RemoveConfigFiles=[none|user|system|all]

Removes configuration files such as .condarc files. user removes the files inside the current user’s home directory and system removes all files outside of that directory.

/RemoveUserData=[0|1]

Removes user data, such as the %USERPROFILE%/.conda directory.

Caution

Using these arguments is not recommended if you have multiple conda installations.

The following command is an example of how the uninstall arguments could be used:

start /wait .\miniconda3\Uninstall-Miniconda3.exe /S /RemoveCaches=1 /RemoveConfigFiles=user /RemoveUserData=1

PowerShell

Open a new PowerShell window and run the following command:

Start-Process -FilePath ".\miniconda3\Uninstall-Miniconda3.exe" -ArgumentList "/S"

As of Miniconda v24.11.1, you can also use additional arguments to remove other files from your system.

Optional uninstall arguments

/RemoveCaches=[0|1]

Removes caches such package caches.

/RemoveConfigFiles=[none|user|system|all]

Removes configuration files such as .condarc files. user removes the files inside the current user’s home directory and system removes all files outside of that directory.

/RemoveUserData=[0|1]

Removes user data, such as the ${env:USERPROFILE}/.conda directory.

Caution

Using these arguments is not recommended if you have multiple conda installations.

The following command is an example of how the uninstall arguments could be used:

Start-Process -FilePath ".\miniconda3\Uninstall-Miniconda3.exe" -ArgumentList "/S /RemoveCaches=1 /RemoveConfigFiles=user /RemoveUserData=1" -Wait

macOS/Linux

1. Open a new terminal application window.

2. Deactivate your base environment by running the following command:

   conda deactivate
   

   You should no longer see (base) in your terminal prompt.

3. As of Miniconda v24.11.1, an uninstaller.sh script 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.

   Note

   If you have installed Miniconda into a system location, you must use sudo -E to run the uninstaller.

   For example, the .pkg installer for macOS installs Miniconda into a system location, /opt/miniconda3.

   Basic uninstall

   ~/miniconda3/uninstall.sh
   

   Basic system uninstall

   sudo -E ~/opt/miniconda3/uninstall.sh
   

   Advanced uninstall

   Caution

   • Including additional uninstall arguments is optional. These arguments remove additional files from your system. Using these arguments is not recommended if you have multiple conda installations.

   • If any files outside the installation directory are symlinks, it’s possible that only the link will be removed, and not the underlying files, meaning you’ll need to find and delete them manually.

   Optional uninstall arguments

   --remove-caches

   Removes caches such package caches.

   --remove-config-files {user,system,all}

   Removes configuration files such as .condarc files. user removes the files inside the current user’s home directory and system removes all files outside of that directory.

   --remove-user-data

   Removes user data, such as the ~/.conda directory.

   The following command is an example of how the uninstall arguments could be used:

   ~/miniconda3/uninstall.sh --remove-caches --remove-config-files user --remove-user-data
   

   Manual uninstall

   1. (Optional) Remove any conda initialization scripts from all your terminal shell profiles by running the following command:

      conda activate
      conda init --reverse --all
      

   2. Remove your entire miniconda3 directory with rm -rf. Depending on your installation, this directory will be in your root folder or in your opt folder.

      Warning

      When paired with the -r (recursive) flag, the f (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 running rm -rf, as this action can’t be undone.

      # The following are a few examples of how you might need to delete your miniconda3 folder
      rm -rf miniconda3
      rm -rf ~/miniconda3
      sudo rm -rf /opt/miniconda3
      

   3. (Optional) Remove the hidden .condarc file and .conda and .continuum directories from your home directory by running the following command:

      Caution

      Consider keeping a backup of the .condarc file, especially if you have custom configurations for conda and are planning on reinstalling.

      rm -rf ~/.condarc ~/.conda ~/.continuum
      

4. (Optional) If you have created any environments outside your miniconda3 directory, you can manually delete them to increase available disc space on your computer.

5. Close and reopen your terminal to refresh it. You should no longer see (base) in your terminal prompt.