Knowledge Base

How to install TurboGears using the A2 QuickInstaller

This article describes how to use the A2 QuickInstaller to install TurboGears, a Python-based web development framework.

The A2 QuickInstaller is no longer supported, and is only available on older VPS hosting packages. On newer VPS hosting packages, you can use Webuzo to quickly and easily install a wide range of applications and manage your server.

To check if the A2 QuickInstaller supports this application for your Linux distribution, please see this article.

Installing TurboGears

To install TurboGears, follow these steps:

  1. Use SSH to log in to your system as the root user.
    To use the A2 QuickInstaller, you must log in as the root user using SSH. You cannot use the serial console in the VPS Control Panel to run the A2 QuickInstaller.
  2. To start the A2 QuickInstaller, type the following command, and then press ENTER:
    sh /usr/sbin/
  3. Under Application Installers, type the option number for Frameworks, and then press ENTER.
  4. On the Framework Menu, type the option number for TurboGears, and then press ENTER. The A2 QuickInstaller updates your system, and then begins the installation process.
    The installation process takes some time to complete. Do not interrupt the installation process.
  5. The A2 QuickInstaller notifies you when installation is complete.

Creating a TurboGears test application

To create a test application and verify that TurboGears installed correctly, follow these steps:

  1. To activate the TurboGears virtual environment, type the following command at the command line, and then press ENTER:
    source /opt/tg2env/bin/activate
  2. To create a test project, type the following command, and then press ENTER:

    paster quickstart testproject
  3. At the Enter package name prompt, press ENTER.
  4. At the Would you prefer mako templates? prompt, press ENTER.
  5. At the Do you need authentication and authorization in this project? prompt, press ENTER.
  6. Type the following command, and then press ENTER:

    cd testproject
  7. To change the development server URL, edit the development.ini file. In the [server:main] section, change the host value to the system's domain name or IP address. You can also change the port value if you want to run the development server on port different from the default value of 8080.
  8. Type the following commands, pressing ENTER after each command:

    python develop
    paster setup-app development.ini
    paster serve development.ini
  9. After the development server starts, type the following URL in your browser, where represents your server's IP address or domain name:

    You should see the default page for the site.

More Information

For more information about TurboGears, please visit