Edgewall Software

Version 3 (modified by shawn.pinet@…, 13 years ago) ( diff )

Updated instructions for the new release. Fixed python-dev package name. Fixed missing symlink to sites-enabled.

Read TracInstall first for a general overview. This is a quick HOWTO specifically for Ubuntu users. I wrote these notes during an install on Ubuntu Hardy Heron.

I consulted:

I ran the following commands as root:

cd /usr/local/src
wget http://ftp.edgewall.com/pub/trac/Trac-0.11.5.tar.gz
tar -zxf Trac-0.11.5.tar.gz
cd Trac-0.11.5
apt-get install python-dev
apt-get install python-xml
apt-get install python-genshi
apt-get install python-subversion
apt-get install python-pysqlite2
apt-get install python-setuptools
apt-get install libapache2-mod-python
python ./setup.py install

Now we need a folder the web server is allowed to write to in which to keep Trac's data. So we'll make that folder and then switch to the www-data user for the next few commands:

mkdir /usr/local/trac
chown www-data.www-data /usr/local/trac
su www-data
svnadmin create /usr/local/trac/repository
trac-admin /usr/local/trac/environment initenv 

The trac-admin command will prompt you for various settings. You can accept the defaults, except for the Subversion repository, which you should set to /usr/local/trac/repository.

htpasswd -c /usr/local/trac/passwords.txt admin

Supply a password for an initial user. You can add more users later. Use the -c option only on the FIRST use of this command, as it creates the password file.

Now it's time to switch back to root to configure Apache. Type exit to log out of the www-data account and return to root. Now set up a virtual host for Trac. Let's say it will be called tractest. You can set it up by creating the file /etc/apache2/sites-available/tractest with the following contents:

<VirtualHost *>
  ServerName tractest
  <Location />
    SetHandler mod_python
    PythonInterpreter main_interpreter
    PythonHandler trac.web.modpython_frontend
    PythonOption TracEnv /usr/local/trac/environment
    PythonOption TracUriRoot /
  </Location>
  <Location /login>
    AuthType Basic
    AuthName "trac"
    AuthUserFile /usr/local/trac/passwords.txt
    Require valid-user
  </Location>

</VirtualHost>

Now, link the site that is available to the list that will startup by default.

ln -s /etc/apache2/sites-available/tractest /etc/apache2/sites-enabled/002-tractest 

Now, as root, signal Apache to reload its configuration and notice the new site:

invoke-rc.d apache2 reload

Finally, add tractest to your DNS or, if you're just setting up a test site for your own use on your own computer, add it to the list of aliases for localhost in your /etc/hosts file:

# List testing sites here
127.0.0.1 localhost tractest

You're ready to go. Visit http://tractest/ and you'll have access to trac. You can log in as the admin user when you click on the login button.

Of course basic authentication isn't the only option. Anything that is backwards-compatible with it should work, including mod_ldap, mod_shib, etc.

Note: See TracWiki for help on using the wiki.