Canopy 2 - failure during runtime or package installation


We recommend that all Canopy 2 users update to the current version of Canopy, 2.1.6 (released November 2, 2017), whose initial environment creation is much more robust than in previous versions. 

We also suggest that you

  • Temporarily disable any anti-virus or Internet security utilities during Canopy environment creation, especially during Canopy's initial startup.
  • Ensure that you have 2 GB free on your installation disk before installing or resetting Canopy (5 GB for full environments, which are not recommended for most users.)

If you are already running the latest version of Canopy, and you still experience an environment installation failure and want to try again (this time with antivirus disabled), there is no need to reinstall Canopy; instead, you need only go to the Canopy Tools => Troubleshoot menu, and select Reset Python Environment.


When you ask Canopy 2 to install a Canopy 2 / EDM Python environment, it goes through two distinct steps. First, the Python runtime (Python interpreter with standard libraries) is installed. Then the specified packages are installed.

The most common causes of Python environment installation errors, before Canopy 2.1.3, appear to be slowdown from an anti-virus utility (especially Avast and McAfee on Windows), and attempts to start Canopy before environment creation is complete.

Starting with Canopy 2.1.2, Canopy automatically retries any failed runtime or package installations. If the failure repeats, then Canopy asks you several more times whether you want to try again. 

Starting with Canopy 2.1.3, Canopy is robust against accidental attempts to start it before Python environment creation is complete.

Starting with Canopy 2.1.5, the Canopy Package Manager and the Enthought Deployment Manager (EDM) included other stability fixes.

We expect that these improvements will be sufficient for environment installation to complete successfully in almost all cases.

If not, please send us a feedback/bug report from the Canopy help menu. Please include:

  • What antivirus program you are using
  • Whether you were able to temporarily disable your antivirus program during environment installation. 


Please do not enter support requests in article comments

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

Have more questions? Submit a request


Powered by Zendesk