This appendix covers detailed, step-by-step instructions for installing Trac and its dependencies, and covers Microsoft Windows and Linux. Trac needs to be installed on your server. You will use a web browser to access it from other machines.
Trac is very easy to install, but has a number of dependencies that must be satisfied first. As Trac is written in Python, our first requirement is obvious. There are several versions of Python available, but the recommended version is 2.4. For data storage Trac can use a variety of databases. SQLite was the only original option, and remains the most popular, primarily because it is the easiest to configure. For these reasons the instructions that follow assume you will also use SQLite.
Note
Keeping your options open
Although these instructions cover only SQLite, you can choose a different database if you wish. Details of using alternatives can be found at:
SQLite is unusual in that there is no server software to install. Instead databases are single files, which can be used by any application that uses the SQLite library. This means that for Trac, we need to have the Python SQLite library installed. In order to communicate with Subversion, Trac requires the Python Subversion library. Finally it uses ClearSilver for its template system.
Note
Future Proofing
Although Trac uses ClearSilver in the version covered by this book (0.10.x), the developers have replaced it with a different system called Genshi for the version currently in development (0.11). Details on Genshi can be found at:
The following section describes the required installations.
1. Download and run
python-2.4.4.msifrom http://www.python.org/ftp/python/2.4.4/python-2.4.4.msi. The following window will be observed.
Note
Although this book is using the latest version available at the time of writing, times do change and software always gets updated. To get the latest version of Python 2.4, visit:
2. Leave Install for all users selected and click Next.
1. Download and run svn-python-1.4.4.win32-py2.4.exe from http://subversion.tigris.org/files/documents/15/38214/ svn-python-1.4.4.win32-py2.4.exe.
Note
The latest version of this package can be found at:
http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91
2. Click Next to skip the welcome screen.
4. Click Next to start the installation.
5. Click Finish to complete the installation.
1. Download and run pysqlite-2.3.5.win32-py2.4.exe from http://initd.org/pub/software/pysqlite/releases/2.3/2.3.5/pysqlite-2.3.5.win32-py2.4.exe.
1. Download and run clearsilver-0.9.14.win32-py2.4.exe from http://www.clearsilver.net/downloads/win32/clearsilver-0.9.14.win32-py2.4.exe.
2. Click Next on the welcome screen.
3. Ensure Python 2.4 is selected and click Next.
4. Click Next to start the installation.
5. Click Finish to complete the installation.
1. Download and run trac-0.10.4.win32.exe from http://ftp.edgewall.com/pub/trac/trac-0.10.4.win32.exe.
2. Click Next at the welcome screen.
3. Ensure Python 2.4 is selected and click Next.
4. Click Next to start the installation.
5. Click Finish to complete the installation.