Knowledge Base/Canopy/Introduction to Canopy & FAQs

Uninstalling and resetting Canopy

Puneeth Chaganti
posted this on April 15, 2013, 01:34

(Revised October 28, 2014)

Note: 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 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

Note: If during install you encountered the error "The specified account already exists", please see this article.

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) Uninstall Enthought Canopy  from:

Control Panel > Add/Remove Programs (Windows XP).

Control Panel > Programs and Features (Windows 7, 8, or Vista).

4) For each Canopy user, delete one or more of the directories below, which contain that user's "System" and "User" virtual environments, and any user macros.

  • Deleting "System" removes the environment where the Canopy GUI application runs; it will be re-created the next time that you start Canopy.
  • Deleting "User" removes 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.
  • Deleting the third directory will remove any Canopy macros which you may have written. It is usually empty.

(For 32-bit Canopy, replace "Canopy" with "Canopy32"):

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

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

Note that 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...)

5) Remove your Canopy configuration / preferences directory, which contains some files that could affect your next install.

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

Mac OSX

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 following  directory:

/Applications/Canopy.app 

4) For each Canopy user, delete one or all of the directories below, which contain that user's "System" and "User" virtual environments, and any user macros.

  • Deleting "System" removes the environment where the Canopy GUI application runs; it will be re-created the next time that you start Canopy.
  • Deleting "User" removes 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.
  • Deleting the third directory will remove any Canopy macros which you may have written. It is usually empty.

(for 32-bit Canopy, replace "64bit" with "32bit"): 

/Users/<your-username>/Library/Enthought/Canopy_64bit/System
/Users/<your-username>/Library/Enthought/Canopy_64bit/User
/Users/<your-username>/Library/Canopy

5) Remove your Canopy configuration / preferences directory, which contains some files that may affect your next install.

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

 7) Restart your computer.

Linux

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 the directories below, which contain that user's "System" and "User" virtual environments, and any user macros.

  • Deleting "System" removes the environment where the Canopy GUI application runs; it will be re-created the next time that you start Canopy.
  • Deleting "User" removes 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.
  • Deleting the third directory will remove any Canopy macros which you may have written. It is usually empty. 

(for 32-bit Canopy, replace "64bit" with "32bit"): 

~/Enthought/Canopy_64bit/System
~/Enthought/Canopy_64bit/User
~/canopy

5) Remove your Canopy configuration / preferences directory, which contains some files that may affect your next install.

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.

 

Comments

User photo
Irais Valencia

How to re-install completely  canopy? Because when I try reinstall does not generate the Enthought directory. Thank you

June 19, 2013, 12:57
User photo
Puneeth Chaganti
Enthought

Did you try running Canopy after the install?  The ~/Enthought directory is re-created on first run, not on install. 

June 19, 2013, 13:20
User photo
Irais Valencia

Thank you for your kind help. The problem have been solved 

June 19, 2013, 14:13
User photo
Christopher Hagmann

I got rid of all of the files you mentioned (Linux) to prep for a clean re-install. When I re-installed, however, It already had me logged in. How did it know?

 

June 24, 2013, 15:26
User photo
Puneeth Chaganti
Enthought

@Christopher, your username and password are stored in a separate file called ~/.enstaller4rc.  This is a file that enpkg uses, as well.

June 24, 2013, 19:37
User photo
Gab Milch

Hi,

I have removed all directories, subdirectories and lines suggested here for Mac OSX, but it still hasn't removed all canopy files, and it still tries to open python files with canopy (pls see screenshot). What do I do now? (I also had previous version of Enthought, that I delted)

Thanks,

 

 

August 5, 2013, 17:50
User photo
Jonathan March
Enthought

Also delete the preferences directory ~/.canopy. What other Canopy files are you referring to?

Clearing file associations in OSX is non-trivial, as you will see if you search for "os x clear file association", and we currently do not provide a way to do this, though it clearly would be desireable. You can, however, reset the association of .py files, as described here:
http://osxdaily.com/2009/10/25/change-file-associations-in-mac-os-x/

Thanks for trying Canopy; sorry that it did not meet your needs.

August 5, 2013, 19:46
User photo
Gab Milch

I deleted ~/.canopy as well earlier, Ok, I guess reset association will have to do. Thanks

August 5, 2013, 20:51
User photo
Jonathan March
Enthought

@Bathala (EdX student): Please heed the instructions above, which read as follows:

"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."

 

When you go to those guidelines, you will see:

"We encourage edX students to first search for answers and post your questions in the Discussion section at the bottom of your relevant edX Courseware page, so that you and other edX students may learn from each other's experiences. If you cannot find an answer there, you are welcome to post to Stack Overflow as just mentioned. Thank you!"

I am deleting your question here. Please post it to Stack Overflow.

January 8, 2015, 21:38
User photo
Sebastien CELLES

On Mac OS X I also have a /Library/Frameworks/EPD64.framework/Versions/Current/bin directory which also need to be delete.

because I noticed #PATH="/Library/Frameworks/EPD64.framework/Versions/Current/bin:${PATH}" in .bashrc

January 19, 2015, 04:40
User photo
Jonathan March
Enthought

@Sebastien -- To be clear, there was no need to delete the EPD directory; Canopy and EPD and other same-version Pythons can coexist comfortably on Mac OS or Linux (although most Canopy users won't actually need to keep an old EPD directory.) The point, rather, is that you should not have more than one Python distribution on your PATH simultaneously.

January 19, 2015, 07:41