Trac on Windows

Python

Trac is written in ​Python, so you will first need to install it.

The recommended version of Python at this time is 2.4.3. Many of Trac's dependencies are not available on Windows for Python 2.5, so that version is not recommended.

Download an run the Python MSI installer: ​python-2.4.3.msi

Setuptools

​Setuptools makes installation of Python software easier by automatically downloading and installing Python packages from the internet. It is also used to find and load Trac's plugins.

Download the setuptools installer: ​ez_setup.py

When the download completes double-click the "ez_setup.py" file from your download folder to install setuptools.

The command line

You'll need to open a command line to install some of the necessary software.

1. Click "Start" > "Run…" (or press Win+R)
2. Type "cmd" and click "Ok"
3. Type "cd \Python24\Scripts"

You should now be in the folder "C:\Python24\Scripts" where you can run the "easy_install" command to install the required software.

Install the ​ClearSilver template language:

easy_install -f http://clearsilver.net/downloads clearsilver==0.9.14

Install the ​PySqlite database driver:

easy_install pysqlite

TODO setting up for PostgreSQL or MySQL

Subversion

This is optional.

Trac can integrate with the ​Subversion version control software. Follow these steps if you'd like to user Trac with Subversion. You can learn more about how they can integrate on TracSubversion.

This document covers using the Subversion command line tools, but you can also use the ​TortoiseSVN Windows GUI.

Download and run the installer for the Subversion command line tools: ​svn-1.4.0-setup.exe

Go back to your command line to install the Subversion Python library:

easy_install -Z http://subversion.tigris.org/downloads/svn-python-1.4.0-py2.4.exe

Note: the "-Z" option is necessary when installing Subversion so that it is "unzipped". Trac will not be able to access Subversion if it is zipped.

Download Trac

Download and run the Trac Windows installer: ​trac-0.10b1.win32.exe

Getting Started

Ok, now that Trac and all its requirements have been installed you can create your first project and try it out.

This example will create the projects in "C:\Projects". This is a good default location, but you can put them in another drive or folder if you prefer.

Back to the command line:

cd \
mkdir Projects
cd Projects

Optional: if you're using Trac with Subversion you can create a new repository for your source code:

mkdir svn
svnadmin create svn\my-project

Initialize a new Trac project environment:

mkdir trac
\Python24\python.exe \Python24\Scripts\trac-admin trac\my-project initenv

Follow the interactive prompts to input information about your project. If you are unsure what to put you can simply press "Enter" to accept the default value.

Subversion users: when asked for the "Path to repository" input the folder of the repository you just created:

Path to repository [/path/to/repos]> c:/Projects/svn/my-project

Try it out

Trac includes a standalone webserver called tracd. You can also use Trac with other webservers, but you should first try tracd to make sure everything's set up and working correctly:

You should still be in the "C:\Projects" folder on the command line:

\Python24\python.exe \Python24\Scripts\tracd -p8000 trac\my-project

Open your browser to ​http://localhost:8000 to test out your new Trac project.

Press Ctrl+Break to stop tracd

Troubleshooting

Unsupported version control system "svn"

The Subversion library is not installed properly. Be sure you used the "-Z" option with easy_install when installing Subversion. TODO link back to that step

What's next?

TODO intro to advanced setup options