Edgewall Software
Home
Trac
Trac Hacks
Genshi
Babel
Bitten
Home
Download
Documentation
Mailing Lists
License
FAQ
Search:
Login
Preferences
Help/Guide
About Trac
Wiki
Timeline
Roadmap
Browse Source
View Tickets
New Ticket
Search
Context Navigation
+0
Start Page
Index
History
Editing TracCgi
Adjust edit area height:
8
12
16
20
24
28
32
36
40
Edit side-by-side
= Installing Trac as CGI = To install Trac as a CGI script, make `trac/cgi-bin/trac.cgi` executable as a CGI by your web server. If you're using Apache HTTPD, there are a couple ways to do that: 1. Use a `ScriptAlias` to map an URL to the CGI: {{{ ScriptAlias /trac.cgi /usr/share/trac/cgi-bin/trac.cgi }}} 2. Copy the `trac.cgi` file into the directory for CGI executables used by your web server (commonly named `cgi-bin`). You can also create a symbolic link, but in that case make sure that the `FollowSymLinks` option is enabled for the `cgi-bin` directory. The first option is recommended as it also allows you to map the CGI to a friendly URL. Now, edit the Apache configuration file and add this snippet, file names and locations changed to match your installation: {{{ Alias /cgi-bin/trac.cgi/chrome/common /usr/share/trac/htdocs ScriptAlias /cgi-bin/trac.cgi /usr/share/trac/cgi-bin/trac.cgi <Directory "/usr/share/trac/htdocs"> Order allow,deny Allow from all </Directory> # Trac need to know where the database is located <Location "/cgi-bin/trac.cgi"> SetEnv TRAC_ENV "/path/to/projectenv" #for Trac > 0.9 Plugincache SetEnv PYTHON_EGG_CACHE "/path/to/eggcache" </Location> }}} ''Note: If Apache complains about the !SetEnv line make sure that the mod_env module is available and enabled.'' ''Note: If you are using the [http://httpd.apache.org/docs/suexec.html Apache suEXEC] feature see [http://projects.edgewall.com/trac/wiki/ApacheSuexec ApacheSuexec] (on the main Trac site).'' == Adding Authentication == The simplest way to enable authentication with Apache is to create a password file. Use the `htpasswd` program to create the password file: {{{ $ htpasswd -c /somewhere/trac.htpasswd admin New password: <type password> Re-type new password: <type password again> Adding password for user admin }}} After the first user, you dont need the "-c" option anymore: {{{ $ htpasswd /somewhere/trac.htpasswd john New password: <type password> Re-type new password: <type password again> Adding password for user john }}} ''See the man page for `htpasswd` for full documentation.'' After you've created the users, you can set their permissions using TracPermissions. Now, you'll need to enable authentication against the password file in the Apache configuration: {{{ <Location "/cgi-bin/trac.cgi/login"> AuthType Basic AuthName "Trac" AuthUserFile /somewhere/trac.htpasswd Require valid-user </Location> }}} ---- See also: TracGuide, TracInstall, TracFastCgi, TracModPython
Note:
See
WikiFormatting
and
TracWiki
for help on editing wiki content.
Change information
Your email or username:
E-mail address and name can be saved in the
Preferences
Comment about this change (optional):
Note:
See
TracWiki
for help on using the wiki.