UbuntuTracHowto
Steps to get Trac working on your computer from commandline
I ommited the full path to the dir where i installed my Trac instance, so instead of reading the whole path, you'll only see ....../Work/MhzProjects/
Decide where you'd like to run SVN and Trac. In my case, I decided to use a dir called MhzSvn and one called MhzTrac, both under MhzProjects/. So cd to that dir
/Work $ cd MhzProjects/
Install Trac and say Y to install everything needed (apache, svn and some python stuff)
/Work/MhzProjects $ sudo apt-get install trac Password:
Create a dir for SVN to work with Trac, then ls to see what SVN just created for you
/Work/MhzProjects $ svnadmin create MhzSvn /Work/MhzProjects $ ls MhzSvn/ conf dav db format hooks locks README.txt
Let Trac create everything for you. I decided to call my trac MhzStuff
/Work/MhzProjects $ trac-admin MhzTrac initenv Creating a new Trac environment at /home/Users/Rojo/mhz/Work/MhzProjects/MhzTrac Trac will first ask a few questions about your environment in order to initalize and prepare the project database. Please enter the name of your project. This name will be used in page titles and descriptions. Project Name [My Project]> MhzStuff Please specify the absolute path to the project Subversion repository. Repository must be local, and trac-admin requires read+write permission to initialize the Trac database. Path to repository [/var/svn/test]> ........../Work/MhzProjects/MhzSvn/ Please enter location of Trac page templates. Default is the location of the site-wide templates installed with Trac. Templates directory [/usr/share/trac/templates]> Creating and Initializing Project Inserting default data Configuring Project trac.repository_dir trac.templates_dir project.name Installing wiki pages /usr/share/trac/wiki-default/TracImport => TracImport /usr/share/trac/wiki-default/TracRss => TracRss /usr/share/trac/wiki-default/TracMultipleProjects => TracMultipleProjects /usr/share/trac/wiki-default/TracBackup => TracBackup /usr/share/trac/wiki-default/TracTimeline => TracTimeline /usr/share/trac/wiki-default/TracTickets => TracTickets /usr/share/trac/wiki-default/TracInstall => TracInstall /usr/share/trac/wiki-default/WikiRestructuredText => WikiRestructuredText /usr/share/trac/wiki-default/WikiPageNames => WikiPageNames /usr/share/trac/wiki-default/TracSyntaxColoring => TracSyntaxColoring /usr/share/trac/wiki-default/TracPermissions => TracPermissions /usr/share/trac/wiki-default/TracSupport => TracSupport /usr/share/trac/wiki-default/WikiHtml => WikiHtml /usr/share/trac/wiki-default/TracModPython => TracModPython /usr/share/trac/wiki-default/WikiFormatting => WikiFormatting /usr/share/trac/wiki-default/TracBrowser => TracBrowser /usr/share/trac/wiki-default/TracTicketsCustomFields => TracTicketsCustomFields /usr/share/trac/wiki-default/TracNotification => TracNotification /usr/share/trac/wiki-default/TracUnicode => TracUnicode /usr/share/trac/wiki-default/TracAccessibility => TracAccessibility /usr/share/trac/wiki-default/TracInstallPlatforms => TracInstallPlatforms /usr/share/trac/wiki-default/TracReports => TracReports /usr/share/trac/wiki-default/TracEnvironment => TracEnvironment /usr/share/trac/wiki-default/WikiMacros => WikiMacros /usr/share/trac/wiki-default/CamelCase => CamelCase /usr/share/trac/wiki-default/WikiProcessors => WikiProcessors /usr/share/trac/wiki-default/TracSearch => TracSearch /usr/share/trac/wiki-default/TracQuery => TracQuery /usr/share/trac/wiki-default/WikiStart => WikiStart /usr/share/trac/wiki-default/TracLogging => TracLogging /usr/share/trac/wiki-default/SandBox => SandBox /usr/share/trac/wiki-default/WikiRestructuredTextLinks => WikiRestructuredTextLinks /usr/share/trac/wiki-default/TracLinks => TracLinks /usr/share/trac/wiki-default/TracRoadmap => TracRoadmap /usr/share/trac/wiki-default/TracStandalone => TracStandalone /usr/share/trac/wiki-default/TracUpgrade => TracUpgrade /usr/share/trac/wiki-default/RecentChanges => RecentChanges /usr/share/trac/wiki-default/TracAdmin => TracAdmin /usr/share/trac/wiki-default/TracGuide => TracGuide /usr/share/trac/wiki-default/TracChangeset => TracChangeset /usr/share/trac/wiki-default/TitleIndex => TitleIndex /usr/share/trac/wiki-default/WikiNewPage => WikiNewPage /usr/share/trac/wiki-default/TracWiki => TracWiki Indexing repository --------------------------------------------------------------------- Project database for 'MhzStuff' created. Customize settings for your project using the command: trac-admin ............/Work/MhzProjects/MhzTrac Don't forget, you also need to copy (or symlink) "trac/cgi-bin/trac.cgi" to you web server's /cgi-bin/ directory, and then configure the server. If you're using Apache, this config example snippet might be helpful: Alias /trac "/wherever/you/installed/trac/htdocs/" <Location "/cgi-bin/trac.cgi"> SetEnv TRAC_ENV ".........../Work/MhzProjects/MhzTrac" </Location> # You need something like this to authenticate users <Location "/cgi-bin/trac.cgi/login"> AuthType Basic AuthName "MhzStuff" AuthUserFile /somewhere/trac.htpasswd Require valid-user </Location> The latest documentation can also always be found on the project website: http://projects.edgewall.com/trac/ Congratulations! /Work/MhzProjects $
- Let's see what Trac created for us
/Work/MhzProjects $ ls -lh MhzTrac total 32K drwxr-xr-x 2 mhz rojo 4.0K 2006-01-04 15:58 attachments drwxr-xr-x 2 mhz rojo 4.0K 2006-01-04 15:58 conf drwxr-xr-x 2 mhz rojo 4.0K 2006-01-04 15:58 db drwxr-xr-x 2 mhz rojo 4.0K 2006-01-04 15:58 log -rw-r--r-- 1 mhz rojo 94 2006-01-04 15:58 README drwxr-xr-x 2 mhz rojo 4.0K 2006-01-04 15:58 templates -rw-r--r-- 1 mhz rojo 27 2006-01-04 15:58 VERSION drwxr-xr-x 2 mhz rojo 4.0K 2006-01-04 15:58 wiki-macros
Edit apache2.conf
/Work/MhzProjects $ sudo nano /etc/apache2/apache2.conf Password:
- Add these lines at the end of the file
Alias /trac "/usr/share/trac/htdocs" <Location "/cgi-bin/trac.cgi"> SetEnv TRAC_ENV "........./MhzProjects/MhzTrac" </Location>
- Re-start apache
sudo /etc/init.d/apache2 restart
Open your browser and visit http://localhost:8000