Table Of Contents

Previous topic

TurboGears 1.0 FAQ

Next topic

Supported Operating Systems

Downloading and Installing TurboGears

Quickstart Instructions

Installing the latest stable version of TurboGears 1.0 from scratch is most easily achieved with the script.

The Standard Way (

There are only two steps necessary to install TurboGears, if you already have Python installed. If you don’t have Python installed on your system (or are not sure about it), please refer to the detailed installation instructions in the next section.

  1. Download the script.

  2. Run the script from the command-line:

    $ python

We strongly suggest that you also refer to the system-specific installation instructions for details.


  • Windows, Mac OS X 10.3/4 or Linux/Unix, see also Supported Operating Systems
  • Python >= 2.3.x, < 3.x (naturally, details see below)
  • An internet connection (for off-line installation 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)


The recommended Python version to use with TurboGears 1.0 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 and Python 2.6.x from 1.0.9 and later.

TurboGears does not support Python 3.x yet.

Database Installation and Configuration

TurboGears is designed to work in conjunction with an object-relational mapper such as SQLObject or SQLAlchemy, so TurboGears can use all the databases supported by these ORMs. If you have one of the supported DBAPI implementations in Database Options, you should be settled.

If you need to choose a database option, SQLite is an easy-to-use database to get started with, which works with plain files or in-memory databases. If you are using Python 2.5, SQLite is supported out of the box and you don’t need to install pysqlite.

Here we list installation and configuration instructions for the most common databases:

Where Are the Download Files?

Generally, downloads are done through the easy_install-based script. There is a list of files available if you need to do something manually.

Specific Version Installation

Installing an older version of TurboGears is possible, too. To install a specific version of TurboGears run a command line similar to this one:

$ easy_install -i TurboGears==1.0.x

Replace 1.0.x with the number of the version of TurboGears which you want to install. This form requires setuptools to be present on your machine. If you don’t have setuptools yet, download and run to install it:

$ wget
$ python

After installing TurboGears you probably also want to install at least one of the object-relational mappers, SQLObject or SQLAlchemy:

$ easy_install SQLAlchemy


$ easy_install SQLObject