NAME¶

roundup-server - start roundup web server

SYNOPSIS¶

roundup-server [options] [name=tracker home]*

OPTIONS¶

-C file

Use options read from the configuration file (see below).

-n hostname

Sets the host name in the Roundup web server interface.

-p port

Sets the port to listen on (default: 8080).

-d file

Daemonize, and write the server's PID to the nominated file.

-l file

Sets a filename to log to (instead of stdout). This is required if the -d option is used.

-i file

Sets a filename to use as a template for generating the tracker index page. The variable "trackers" is available to the template and is a dict of all configured trackers.

-s

Enables to use of SSL.

-e file

Sets a filename containing the PEM file to use for SSL. If left blank, a temporary self-signed certificate will be used.

-N

Log client machine names instead of IP addresses (much slower).

-u UID

Runs the Roundup web server as this UID.

-g GID

Runs the Roundup web server as this GID.

-d PIDfile

Run the server in the background and write the server's PID to the file indicated by PIDfile. The -l option must be specified if -d is used.

-v

Print version and exit.

-h

Print help and exit.

name=tracker home

Sets the tracker home(s) to use. The name variable is how the tracker is identified in the URL (it's the first part of the URL path). The tracker home variable is the directory that was identified when you did "roundup-admin init". You may specify any number of these name=home pairs on the command-line. For convenience, you may edit the TRACKER_HOMES variable in the roundup-server file instead. Make sure the name part doesn't include any url-unsafe characters like spaces, as these confuse the cookie handling in browsers like IE.

EXAMPLES¶

roundup-server -p 9000 bugs=/var/tracker reqs=/home/roundup/group1

Start the server on port 9000 serving two trackers; one under /bugs and one under /reqs.

CONFIGURATION FILE¶

See the "admin_guide" in the Roundup "doc" directory.

AUTHOR¶

This manpage was written by Bastian Kleineidam <calvin@debian.org> for the Debian distribution of roundup. The main author of roundup is Richard Jones <richard@users.sourceforge.net>.