Uninstalling and resetting Canopy v2

Notes 

  • To uninstall Canopy version 1, see this article instead.

  • If you are uninstalling because you are having problems and want to do a clean re-install, and you already have the current version of Canopy installed, we suggest just doing a "Full Reset", i.e. steps 4 and 5 from the procedure below. This will be much quicker than a full uninstall & re-install. It only requires deleting some directories, then re-starting Canopy, which will re-create those directories to reset a clean working environment

 

Windows (Vista or higher)

Note: If during install you encountered the error "The specified account already exists", please email support@enthought.com with a screenshot of the error.

1) From the Canopy preferences menu, Unset Canopy as your default Python.

2) Restart your computer.

3) Uninstall Enthought Canopy from the Control Panel > Programs and Features. For Windows 8 & 10, be sure to use the Control Panel, and not the System Settings > Apps and Features (which will often fail to uninstall Canopy).

4) For each Canopy user, delete one or more of these directories/files:

C:\Users\<username>\AppData\Local\Enthought\Canopy\edm (for Canopy 64-bit
C:\Users\<username>\AppData\Local\Enthought\Canopy_32bit\edm  (for Canopy 32-bit)
C:\Users\<username>\Canopy
C:\Users\<username>\.enstaller4rc

(To see the AppData or Local Settings directories in Windows Explorer, you must set Explorer to show hidden files (Computer / Organize / Folder & Search Options / View / Advanced settings / Show hidden...)

More info:

  • Deleting the "edm" directory removes your "Canopy Python User environment", consisting of Python and all your installed Python packages. It will be re-created with only the packages bundled into the Canopy installer, the next time that you start Canopy. This is usually recommended for a clean starting package set, unless you have many external packages installed, which would be painful for you to re-install manually. This is the directory that you need to delete if you are changing between Python 2.7 and 3.5 in Canopy 2.0. 
  • Deleting the <username>\Canopy directory will remove any Canopy macros which you may have written. It is usually empty, and if it is not, you may want to keep it to preserve any Canopy macros that you have written.
  • Deleting .enstaller4rc will remove some login information, after which you may need to log in again. If this file was corrupted, it may have caused problems.
 

5) (This step is not normally required, but can be useful if you are having problems and want to do a full reset of your Canopy installation.) Delete the files "locations.cfg" and "preferences.ini" from each user's Canopy configuration / preferences directory.

If problems persist, or for complete Canopy removal, delete this directory entirely; if you do so, the user will lose bookmarks and recent file list.

6) (This step is not needed if you plan to re-install Canopy; it is only needed if you are trying to remove Canopy completely): If you did not do step 1 for whatever reason, then manually delete any of the following keys from your Windows registry, if they refer to Canopy:

HKEY_CURRENT_USER\Software\Python\PythonCore\2.7\InstallPath
HKEY_CURRENT_USER\Software\Python\PythonCore\2.7\PythonPath
HKEY_LOCAL_MACHINE\Software\Python\PythonCore\2.7\InstallPath
HKEY_LOCAL_MACHINE\Software\Python\PythonCore\2.7\PythonPath

7) Restart your computer.

 

Note: Sometimes Windows will fail to fully uninstall a program, making it difficult to install a new version or alternative program. To help work around this problem, Microsoft has provided the tiny utility "MsiZap.exe", which can forcibly remove all references to your Canopy installation, from the Windows registry. This utility is freely available as part of the Microsoft Windows SDK, and is also downloadable here for convenience (the MD5 hash of this file is 8a6469cbed9cde987d12f857dba97640).

MsiZap requires admin privileges to run.

After downloading, do not try to open/run it in your browser or from Windows Explorer (this will accomplish nothing, good or bad). Instead, to run it:

1) Open a Command Prompt window from the Windows Start menu. Type the following commands in this window.

2) Use the CD command to navigate to your download directory. On most systems, typing this will work:

cd %USERPROFILE%\Downloads

3) For a Canopy 64-bit installation (v2.0.1) type:

Python 2.7 installation:

msizap T {B2353A28-2838-439C-9F93-A98C67212C17}

Python 3.5 installation:

msizap T {F5696384-5CD0-4A9F-BA15-E58BC86D91AE}

Or, for a Canopy 32-bit installation, type:

Python 2.7 installation:

msizap T {9BDE5C08-4A14-4159-B849-38963FBDB637}

Python 3.5 installation:

msizap T {4A59225A-0AA5-4A75-8654-5EBBB22524EC}

In either case, if you still have the Canopy installer file available, you can refer to the installer file instead of specifying the product code. For example:

msizap T canopy-2.0.1.3444.win-x86_64.msi 

4) MsiZap does not remove the Canopy Core environment. To remove this (in addition to deleting the directories described in steps 4 and 5 in the previous section), delete the following (For 32-bit Canopy, replace "Canopy" with "Canopy32"):

# Windows 7, 8, 10, or Vista:
C:\Users\<username>\AppData\Local\Enthought\Canopy\App

# Windows XP:
C:\Documents and Settings\<username>\Local Settings\Application Data\Enthought\Canopy\App

 

Mac OSX

1) From the Canopy preferences menu, Unset Canopy as your default Python.

2) Restart your computer.

3) Remove the following directories:

/Applications/Canopy.app 

4) For each Canopy user, delete one or more of these directories/files:

/Users/<your-username>/Library/Enthought/Canopy/edm
/Users/<your-username>/Library/Canopy
/Users/<your-username>/.enstaller4rc

More info:

  • Deleting the "edm" directory removes your "Canopy Python User environment", consisting of Python and all your installed Python packages. It will be re-created with only the packages bundled into the Canopy installer, the next time that you start Canopy. This is usually recommended for a clean starting package set, unless you have many external packages installed, which would be painful for you to re-install manually. This is the directory that you need to delete if you are changing between Python 2.7 and 3.5 in Canopy 2.0. 
  • Deleting  the ~/Library/Canopy directory will remove any Canopy macros which you may have written. It is usually empty, and if it is not, you may want to keep it to preserve any Canopy macros that you have written.
  • Deleting .enstaller4rc will remove some login information, after which you may need to log in again. If this file was corrupted, it may have caused problems.
 

5) (This step is not normally required, but can be useful if you are having problems and want to do a full reset of your Canopy installation.) Delete the files "locations.cfg" and "preferences.ini" from each user's Canopy configuration / preferences directory.

If problems persist, or for complete Canopy removal, delete this directory entirely; if you do so, the user will lose bookmarks and recent file list.

6) If you are uninstalling completely, edit the following files to delete any lines which reference Canopy (usually, the Canopy-related lines will have been commented out by step 1 but on some system configurations the lines might remain):

/Users/<your-username>/.bash_profile
/Users/<your-username/.profile
/Users/<your-username>/.bashrc

7) Restart your computer.

 

Linux

(Canopy 2.1 or later)


1) From the Canopy preferences menu, Unset Canopy as your default Python (this step is not available on very early versions of Canopy).

2) Restart your computer.

3) Remove the "~/Canopy" directory (or the directory where you installed Canopy).

4) For each Canopy user, delete one or more of these directories/files:

~/Enthought/Canopy/edm
~/canopy
~/.enstaller4rc

More info:

  • Deleting the "edm" directory removes your "Canopy Python User environment", consisting of Python and all your installed Python packages. It will be re-created with only the packages bundled into the Canopy installer, the next time that you start Canopy. This is usually recommended for a clean starting package set, unless you have many external packages installed, which would be painful for you to re-install manually.
  • Deleting  ~/canopy will remove any Canopy macros which you may have written. It is usually empty, and if it is not, you may want to keep it to preserve any Canopy macros that you have written.
  • Deleting .enstaller4rc will remove some login information, after which you may need to log in again. If this file was corrupted, it may have caused problems.

5) (This step is not normally required, but can be useful if you are having problems and want to do a full reset of your Canopy installation.) Delete the files "locations.cfg" and "preferences.ini" from each user's~ Canopy configuration / preferences directory.

If problems persist, or for complete Canopy removal, delete this directory entirely; if you do so, the user will lose bookmarks and recent file list.

6) If you are uninstalling completely, edit the following files to delete any lines which reference Canopy (usually, the Canopy-related lines will have been commented out by step 1 but on some system configurations the lines might remain):

~/.bashrc
~/.bash_profile
~/.profile

7) Restart your computer.

Please do not enter support requests in article comments

Please use article comments for suggestions to improve the article. For individual support requests, please follow these guidelines.

Have more questions? Submit a request

Comments

Powered by Zendesk