Table Of Contents

Previous topic

TurboGears installation on Unix-like Systems

Next topic

TurboGears Installation on Mac OS X

TurboGears Installation on Windows

Getting Python

If you’re new to Python, welcome. It’s a great language

  1. Grab the Python 2.5 Installer.

  2. Run the installer.

  3. Add Python to your path.

    To do this, go to System Properties -> Advanced -> Environment Variables and add or edit the PATH variable to have ;C:\Python25;C:\Python25\Scripts, assuming you installed Python to the default location.


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.

Installing TurboGears

You can run Python from any shell if your Python scripts directory is on your path. By default the scripts directory is C:Python25Scripts

  1. Open up a command line prompt (Start -> Run and type cmd)
  2. Download and run
  1. Make sure your installation succeeded by running tg-admin info.

Once you’ve gotten TurboGears and a database driver installed, jump over to the 20 minute wiki tutorial or the getting started guide to get your feet wet.

Also consider signing up for the discussion or announcement mailing list. We’re always happy to help people work through their problems and you might have something to share with us. There’s also an irc channel, #turbogears on

Database Drivers

If you’re just doing development on your desktop, you can use pysqlite. You can get the latest version from the pysqlite download page.


easy_install pysqlite does not work currently for all versions of Python. Use the binary installer for your Python version from the pysqlite page instead.

If you’re doing this on a production server, you’ll probably want to use MySQL (using the MySQLdb driver) or Postgres (using the psycopg2 driver), though you could use several other databases if you like.

Get Help

For the most part, installation goes off without a hitch, but if you have problems, feel free to ask for help.