Linux Installation

First download a Linux installer from the Canopy download page.

For almost all users, the Standard Installers are the best choice. Full installers are only intended for shared or offline installations which will not be updated after installation. For details, see Installing a new Canopy version.

Canopy for Linux is distributed as a self-extracting shell script. Once the file is downloaded the install can be started by executing the following command (or similar, depending on the Canopy installer version):

bash canopy-2.1.3-rh6-x86_64-cp35.sh

Please note that the Canopy application is normally installed by an ordinary user, not running as root, into the user’s own home directory. It is usually not appropriate to precede the bash command with sudo.

The installer will present the Canopy End User License Agreement for approval. If you agree to the license, the next prompt is for the installation location. The default installation location is ~/Canopy.

Note: Canopy uses a separate Python environment as described in Where are all of the Python packages in my Canopy Python Environments?, the Canopy installation location is not where users will actually run Canopy User Python; therefore it is not appropriate to place it on your PATH environment variable. See Environment setup, below.

Environment setup

Once the installation process is complete, the last step is to set up your personal Python environment. The GUI will walk through the standard setup process.

The remainder of this section describes the standard GUI setup process. However note that there are also two other ways to set up your Python environment:

• For administrators and users who wish to set up and use Canopy without the GUI, i.e. will only use a command-line based environment, please see the section on Setting up and using Canopy without a GUI.
• Systems administrators interested in setting up Canopy on a multi-user machine or network may be interested in Creating a system-wide Canopy install.

Standard GUI setup:

Canopy can be launched by executing the Canopy application from the application directory. If Canopy is installed in ~/Canopy, type:

~/Canopy/canopy

When Canopy is launched for the first time, it will automatically configure your Python environment in the default location. This step allows each user on a multi-user machine to have his or her own local Python installation which shares common GUI components across users. For more information about the environment location, see Where are all of the Python packages in my Canopy Python Environments?.

This setup step typically takes less than two minutes to complete. On Linux the Python environment is installed in ~/.local/share/canopy/edm/envs/User.

At this point Canopy has been set up and is ready to use.