Trac Standalone Server On Windows

This Windows specific guide is heavily based on the generic TracInstall guide with bits and pieces borrowed from TracOnWindows

The goal of this guide is to get Windows users up and running as quickly as possible with the minimal amount of fuss.

So if you just want to set up Trac on a Windows machine to play around with the features in Trac use this setup.

This setup uses the tracd stand alone server and does not require installation and configuration of a separate webserver like Apache. To read about the pro's and con's of a tracd based install compared to other options see the generic TracStandalone page. That page also contains some additional tips for a Windows setup.

For a more verbose guide including more options and possible hints if you run into problems see TracOnWindows

This short guide takes you through these steps:

1. Downloading other required binary packages and Trac itself
2. Installing everything
3. Creating a Project Environment
4. Running tracd the Standalone Server
5. Using Trac (and Subversion)

Downloading Requirements

To install Trac, the following software packages must be installed:

• ​Python, version 2.3.5.
  • Note: Python 2.4 is not recommended on Windows yet since there are no Subversion bindings compatible with Apache available.
• ​Subversion, version 1.2.3
• ​Python bindings for Subversion, version 2.3-1.2.3 (must correspond to both Python and Subversion versions mentioned above)
• ​ClearSilver, version 0.9.14
• ​PySQLite, version 1.1.6
• ​Trac, version 0.9b1

Installing Everything

1. Install Subversion

2. Install Python

Add C:\Python23 to the PATH environment variable (or you will have to supply the path on every call to python in the sections below)

3. Install everything else by following the steps in the TracOnWindows#InstallTracPrerequisites section.

Creating a Project Environment

A Trac environment is the backend storage where Trac stores information like wiki pages, tickets, reports, settings, etc. An environment is basically a directory that contains a human-readable configuration file and various other files and directories.

A new environment is created using trac-admin:

C:\> svnadmin create C:\path\to\svn_project
C:\Python23\Scripts> python trac-admin C:\path\to\trac_env initenv

trac-admin will prompt you for the information it needs to create the environment, such as the name of the project, the database connection string, and so on.

Running the Standalone Server

After having created a Trac environment, you can easily try the web interface by running the standalone server tracd:

C:\Python23\Scripts> python tracd --port 8000 C:\path\to\projectenv

Then, fire up a browser and visit http://localhost:8000/. You should get a simple listing of all environments that tracd knows about. Follow the link to the environment you just created, and you should see Trac in action.

Using Trac (and Subversion)

Once you have your Trac site up and running, you should be able to browse your subversion repository, create tickets, view the timeline, etc.

Keep in mind that anonymous (not logged in) users can by default access most but not all of the features. You will need to configure authentication and grant additional permissions to authenticated users to see the full set of features.

Enjoy''

—- See also: TracGuide, TracStandalone, TracUpgrade, TracPermissions, TracOnWindows