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)