---
name: "roundup-server"
section: "1"
platform: "linux"
package: "roundup"
version: "1.4.20-1.1+deb8u1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/roundup-server"
---

# roundup-server(1)

start roundup web server

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