Uninstalling and resetting Canopy 2

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 2 installed, we suggest not actually reinstalling, but just resetting Canopy's User Python environment from the Canopy Tools menu => Troubleshoot submenu. If this is not sufficient, the next simple step to try would be to delete the preferences.ini file or the entire configuration directory, as described in step 4 below. 

 

Windows (7 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) Restart your computer.

2) 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).

3) For each Canopy user, delete one or more of these directories/files if they exist:

C:\Users\<username>\AppData\Local\Enthought\Canopy\edm (for Canopy 64-bit
C:\Users\<username>\AppData\Local\Enthought\Canopy32\edm  (for Canopy 32-bit)
C:\Users\<username>\Canopy
C:\Users\<username>\.enstaller4rc
C:\Users\<username>\.canopy_runtimes.json
C:\Users\<username>\.ipython
C:\Users\<username>\.jupyter

(By default, the AppData directory and its subdirectories are hidden when you are browsing in the Windows File Explorer. To see one of these directories, you can paste its full path into the Address Bar at the top of the Windows File Explorer)

More info:

  • Deleting the "edm" directory removes your "Canopy Python User environment", consisting of Python and all your installed Python packages, and any other Canopy Python environments that you have created in Canopy or by using Canopy's embedded EDM.
  • 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. It will only be present if you were using a 2017 or earlier version of Canopy or EPD.
  • Deleting the .python and .jupyter directories will remove any custom ipython / jupyter configuration.
 

4) (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 file "preferences.ini" from each user's Canopy configuration / preferences directory (C:\Users\<username>\AppData\Roaming\Enthought\Canopy)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.

 

5) 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 

If you had installed Canopy "For all users", then you should specify "msizap WT" rather than "msizap T".

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

C:\Users\<username>\AppData\Local\Enthought\Canopy\App

 

Mac OSX

1) Restart your computer.

2) Remove the following directories:

/Applications/Canopy.app 

3) 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, and any other Canopy Python environments that you have created in Canopy or by using Canopy's embedded EDM. 
  • 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.
 

4) (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 file "preferences.ini" from each user's Canopy configuration / preferences directory (~/.canopy). 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.

5) If you are uninstalling completely, edit the following files to delete any lines which reference Canopy:

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

6) Restart your computer.

 

Linux

1) Restart your computer.

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

3) 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, and any other Canopy Python environments that you have created in Canopy or by using Canopy's embedded EDM.
  • 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.

4) (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 file "preferences.ini" from each user's Canopy configuration / preferences directory (~/.canopy). 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.

5) 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

6) Restart your computer.

Please do not enter support requests in article comments

Please use article comments for suggestions to improve the article. See "How to submit Enthought Canopy/EPD support requests".

Have more questions? Submit a request

Comments

  • Avatar
    Paul Offord

    I installed Canopy 2 on Centos 7. As normal, I ran the installation shell script as sudo, choosing /home/_userid_/Canopy for the installation.

    I found that the Canopy startup that runs the python environment setup gave a Runtime Error as it requires R/W access to ~/Canopy/LOCAL-REPO so I did a sudo chown -R _userid_ ~/Canopy/LOCAL-REPO.

    This fixed the problem.

Powered by Zendesk