Installation
************

Warning:

  We advise installing virtualenv-1.9 or greater. Prior to version
  1.9, the pip included in virtualenv did not download from PyPI over
  SSL.

Warning:

  When using pip to install virtualenv, we advise using pip 1.3 or
  greater. Prior to version 1.3, pip did not download from PyPI over
  SSL.

Warning:

  We advise against using easy_install to install virtualenv when
  using setuptools < 0.9.7, because easy_install didn't download from
  PyPI over SSL and was broken in some subtle ways.

To install globally with "pip" (if you have pip 1.3 or greater
installed globally):

   $ [sudo] pip install virtualenv

To install locally (to ~/bin and ~/lib) with "pip" (if you have pip
1.3 or greater installed globally):

   $ export PYTHONUSERBASE=$HOME
   $ pip install --user virtualenv

Note: This assumes you have $HOME/bin in your $PATH for later usage of
virtualenv.

Or to get the latest unreleased dev version:

   $ [sudo] pip install https://github.com/pypa/virtualenv/tarball/master

To install version "X.X.X" globally from source:

   $ [sudo] pip install https://github.com/pypa/virtualenv/tarball/X.X.X

To *use* locally from source:

   $ curl --location --output virtualenv-X.X.X.tar.gz https://github.com/pypa/virtualenv/tarball/X.X.X
   $ tar xvfz virtualenv-X.X.X.tar.gz
   $ cd pypa-virtualenv-YYYYYY
   $ python virtualenv.py myVE

Note:

  The "virtualenv.py" script is *not* supported if run without the
  necessary pip/setuptools/virtualenv distributions available locally.
  All of the installation methods above include a "virtualenv_support"
  directory alongside "virtualenv.py" which contains a complete set of
  pip and setuptools distributions, and so are fully supported.
