First, please note that Python 2.3 users on Windows will need to install subprocess.exe before beginning the installation (whereas Python 2.4 users on Windows do not). All windows users also should read the section Post install tweaks for Windows after installation. Users of Ubuntu/debian will also likely need to install the python-dev package.

System-wide Install

To install Pylons so it can be used by everyone (you'll need root access).

If you already have easy install:

1	$ easy_install Pylons==0.9.6.2

Note

On rare occasions, the python.org Cheeseshop goes down. It is still possible to install Pylons and its dependencies however by specifying our local package directory for installation with:

easy_install -f http://pylonshq.com/download/ Pylons==0.9.6.2

Which will use the packages necessary for the latest release. If you're using an older version of Pylons, you can get the packages that went with it by specifying the version desired:

easy_install -f http://pylonshq.com/download/0.9.5/ Pylons==0.9.5

Otherwise:

Download the easy install setup file from http://peak.telecommunity.com/dist/ez_setup.py
Run:

1	$ python ez_setup.py Pylons==0.9.6.2

Note

You may optionally install (or upgrade to at a later date) one of the following 'extras', by specifying the extra name in the command:

easy_install Pylons[extra]==0.9.6.2

pudge: Support for building documentation, see Adding Documentation to your Application. Be aware that some of the documentation tools are under development and may not be stable

genshi: Support for rendering genshi templates, see Using Other Template Languages

cheetah: Support for rendering cheetah templates, see Using Other Template Languages

kid: Support for rendering kid templates, see Using Other Template Languages

full: All of the above

Note

If you are trying to install a version of Pylons earlier than 0.9.4 with an old version of Paste and you have problems compiling Cheetah's _namemapper.c file on your platform you may need to install a precompiled copy using the appropriate tools for your platform. On Ubuntu for example the correct command for Python 2.4 cheetah support is:

apt-get install python2.4-cheetah

Custom Install Location

If you'd like to use a custom installation location, follow the steps there, then install Pylons as shown above. Reading the Easy Install documentation can be useful to determine if you'd prefer system-wide installation or not.

Upgrading

To upgrade to the latest version of Pylons run:

1	$ easy_install -U Pylons==0.9.6.2

Living on the Cutting Edge

Not satisfied with the latest release? Want to be on the cutting edge or work with Pylons source code? Feel free to get involved with Pylons and work with the latest development version.

Easy Install Problems

Occasionally Easy Install fails to find a package it is looking for or a new version of a package which Pylons depends on is released which doesn't install correctly. In this situation ensure you have the latest version of setuptools by running:

1	$ easy_install -U setuptools

Try to install Pylons again and if one of the dependencies still fails you should easy_install a working version of the package manually before installing Pylons.

As an example, if say you had a problem installing Mako you could specify a location where easy_install should look for the latest version:

1	$ easy_install -U -f http://pylonshq.com/download/ Mako

Alternatively you could easy_install Mako directly by specifying the URL of the distribution you want to install. In this case we are installing Mako 0.1.8 from the cheeseshop, but you will need to install the appropriate file for the version of Pylons you are using:

1	$ easy_install -U http://pypi.python.org/packages/source/M/Mako/Mako-0.1.8.tar.gz#md5=b4f3528ec0986a91e38c7f329a3f2b82

Installing Other Software

While most Pylons-related software is available on the Python Cheeseshop and can be installed with the easy_install command not all of it is. A notable exception is the MySQLdb module which allows Python to communicate to MySQL databases. If your application requires software which isn't on the cheeseshop you will have to visit the project site and manually install it according to the instructions on the site. Most commonly used software which isn't on the cheeseshop will be available through your platform's software repository. For example there are versions of MySQLdb available for Windows which you can install with their installer and MySQLdb is available through the repositories for Debian, Ubuntu, Fedora and other platforms.