.. _install_linux:
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
:ref:`venv_where_are_packages`, 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 :ref:`environment_setup_linux`,
below.
.. _environment_setup_linux:
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*
:ref:`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*
:ref:`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 :ref:`venv_where_are_packages`.
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.
..
Local Variables:
mode: rst
indent-tabs-mode: nil
sentence-end-double-space: nil
fill-column: 80
End: