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>.

                                           27 July 2004                         ROUNDUP-SERVER(1)