Premiere version : mise en route du suivi.
[auf_roundup.git] / share / man / man1 / roundup-server.1
CommitLineData
c638d827
CR
1.TH ROUNDUP-SERVER 1 "27 July 2004"
2.SH NAME
3roundup-server \- start roundup web server
4.SH SYNOPSIS
5\fBroundup-server\fP [\fIoptions\fP] [\fBname=\fP\fItracker home\fP]*
6.SH OPTIONS
7.TP
8\fB-C\fP \fIfile\fP
9Use options read from the configuration file (see below).
10.TP
11\fB-n\fP \fIhostname\fP
12Sets the host name.
13.TP
14\fB-p\fP \fIport\fP
15Sets the port to listen on.
16.TP
17\fB-d\fP \fIfile\fP
18Daemonize, and write the server's PID to the nominated file.
19.TP
20\fB-l\fP \fIfile\fP
21Sets a filename to log to (instead of stdout). This is required if the -d
22option is used.
23.TP
24\fB-i\fP \fIfile\fP
25Sets a filename to use as a template for generating the tracker index page.
26The variable "trackers" is available to the template and is a dict of all
27configured trackers.
28.TP
29\fB-s\fP
30Enables to use of SSL.
31.TP
32\fB-e\fP \fIfile\fP
33Sets a filename containing the PEM file to use for SSL. If left blank, a
34temporary self-signed certificate will be used.
35.TP
36\fB-h\fP
37print help
38.TP
39\fBname=\fP\fItracker home\fP
40Sets the tracker home(s) to use. The \fBname\fP variable is how the tracker is
41identified in the URL (it's the first part of the URL path). The \fItracker
42home\fP variable is the directory that was identified when you did
43"roundup-admin init". You may specify any number of these name=home pairs on
44the command-line. For convenience, you may edit the TRACKER_HOMES variable in
45the roundup-server file instead. Make sure the name part doesn't include any
46url-unsafe characters like spaces, as these confuse the cookie handling in
47browsers like IE.
48.SH EXAMPLES
49.TP
50.B roundup-server -p 9000 bugs=/var/tracker reqs=/home/roundup/group1
51Start the server on port \fB9000\fP serving two trackers; one under
52\fB/bugs\fP and one under \fB/reqs\fP.
53
54.SH CONFIGURATION FILE
55See the "admin_guide" in the Roundup "doc" directory.
56.SH AUTHOR
57This manpage was written by Bastian Kleineidam
58<calvin@debian.org> for the Debian distribution of roundup.
59
60The main author of roundup is Richard Jones
61<richard@users.sourceforge.net>.