Downloading and installing a TurboGears beta version

Status:	Draft

This page is about installing unfinished, beta versions of TurboGears for those who want to try out a new TurboGears version before its release or help with development.

These releases are not meant for production use and are not supported. People who are trying out beta releases are supposed to know what they are doing. That being said, if you are having trouble with these releases, you can write to the mailing list or submit a bug report. See also the installation troubleshooting page.

Contents

Quickstart instructions
Requirements
Detailed platform-specific instructions
Database installation and configuration
Where are the download files?
Specific version installation

Quickstart instructions

To install the latest TurboGears beta version, do the following:

Download tgsetup-betaversion.py from the TurboGears web site.
Run the following in your command shell (use sudo only on Unix/Mac OS X if you are installing as a non-root user):
```
[sudo] python tgsetup-betaversion.py
```

This will download and install the TurboGears beta version and all dependencies. It will install the tg-admin script and helper scripts for third-party packages, like kidc, cheetah etc., into /usr/local/bin (Unix) resp. in the Scripts directory in your Python installation (Windows).

See section "Specific version installation" below for detailed instructions on how to install a different (beta) version.

Requirements

Windows, Mac OS X 10.3/4/5 or Linux/Unix
Python >= 2.3.x (Of course. Details see below)
About 20-25 MB of disk space, depending on your OS, architecture and filesystem
On some systems you need a C compiler, to compile Python C-extensions from some components that are required by TurboGears. See the detailed instructions for your platform for details.
If you need to compile extensions, you'll also need Python header files and libraries. If they are not included in your Python installation, they can usually be installed with a package called python-dev, python-devel or similar.
(Recommended) A database system (see below)

Note: The recommended Python version to use with TurboGears currently is 2.5.x, but we still support Python 2.4.x and (with some restrictions) Python 2.3.x. Python 2.5.x is supported from TurboGears version 1.0.2 onwards.

Detailed platform-specific instructions

On some systems you may need to first install some of the above mentioned requirements. Though we don't provide detailed instructions for this for the TurboGears beta version, you can refer to the matching section of the stable version installation guide for some ideas.

Database installation and configuration

Please refer to the stable version installation guide.

Where are the download files?

There is a list of all files hosted on turbogears.org available if you need to do something manually.

Specific version installation

Installing a specific version of TurboGears is always possible since we keep all our files online, but you need to know that in this particular case you'll have to install SQLObject or SQLAlchemy manually at the minimum. Run a command line similar to this one and substitute the version number at the end with the desired one:

[sudo] easy_install --script-dir=/usr/local/bin \
    -f http://www.turbogears.org/download/filelist.html \
    TurboGears==1.0.4b3

This requires setuptools to be present on your machine. If you need to install setuptools, do so by following the instructions below:

wget http://peak.telecommunity.com/dist/ez_setup.py
python ez_setup.py

This will download and install setuptools on your machine, you can now issue commands like easy_install for installing SQLObject or SQLAlchemy:

easy_install "SQLAlchemy>=0.4"

or:

easy_install SQLObject