summaryrefslogtreecommitdiff
blob: 86368f33a1357ee3c778489bfa54eb79699471b3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
Install Instructions
====================

To complete the install, create your first Trac environment by running this command:

	trac-admin /var/lib/trac/<project-name> initenv

For security, trac relies on the webserver for authentication. The following command
creates a password database for Basic Authentication with Apache 2: 

	htpasswd2 -c /etc/apache2/trac.htpasswd <user-name>

Please adjust for the webserver of your choice, and refer to your webserver's
documentation.

Now, all you need to do is to configure your webserver. The following is a configuration
example for CGI and Apache:

	<Location "/cgi-bin/trac.cgi">
		SetEnv TRAC_ENV "/var/lib/trac/<project-name>"
	</Location>
	<Location "/cgi-bin/trac.cgi/login">
		AuthType Basic
		AuthName "trac"
		AuthUserFile /etc/apache2/trac.htpasswd
		Require valid-user
	</Location>

Again, please adjust for the webserver of your choice.

Fast-CGI users: you have to emerge and configure your Fast-CGI engine separately.

You can also use Trac without having to install a webserver. See
http://projects.edgewall.com/trac/wiki/TracStandalone to know more.

Don't forget to update the configuration file! It is located at
/var/lib/trac/<project-name>/conf/trac.ini. See its reference at
http://projects.edgewall.com/trac/wiki/TracIni.

More information (multiple projects setup, installation with Apache 2's mod_python,
lighttpd...) can be found on the Trac wiki:

	http://projects.edgewall.com/trac/wiki/