---
name: "gnocatan-server-console"
section: "6"
platform: "linux"
package: "gnocatan-server-console"
version: "0.8.1.59-1sarge1"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/gnocatan-server-console"
---

# gnocatan-server-console(6)

command-line game server for Gnocatan

## NAME

gnocatan-server-console - command-line game server for Gnocatan

## SYNOPSIS

**gnocatan-server-console** \[ **-a** *port* \] \[ **-c** *AI count* \] \[ **-g** *game name* \] \[ **-k** *seconds* \] \[ **-m** *metaserver* \] \[ **-n** *hostname* \] \[ **-P** *player count* \] \[ **-p** *port* \] \[ **-R** *\[0\|1\|2\]* \] \[ **-r** \] \[ **-s** \] \[ **-t** *minutes* \] \[ **-T** *\[0\|1\]* \] \[ **-v** *points* \] \[ **-x** \]

## DESCRIPTION

This manual page documents briefly the **gnocatan-server-console** command.

**Gnocatan** is an implementation of the popular, award-winning "Settlers of Catan" board game for the GNOME desktop environment.  It uses a client/server model for networked play of between two and eight players.  This program provides a console-only server that **gnocatan** clients can connect to.

## OPTIONS

- **-a** *port*

  Listen for administrative commands on port *port*.

- **-c** *num*

  Start up *num* computer players.

- **-g** *name*

  Load the ruleset specified by *name*.

- **-k** *secs*

  Automatically stop the server if no one has connected after *secs* seconds.

- **-m** *metaserver*

  Register this server with the metaserver at the specified address.

- **-n** *hostname*

  Use this hostname instead of the hostname reported by  **[hostname(1)](/hostname/1.md)**.

- **-P** *num*

  Start a game for *num* total players (including computer players).

- **-p** *port*

  Use port *port* for player connections.

- **-R \[0\|1\|2\]**

  "Sevens rule": Specify gameplay behavior when a player rolls a seven.  A value of *0* (the default) means that rolling a seven always moves the robber.  A value of *1* requires the player to re-roll if a seven is rolled on the first two turns.  A value of *2* means the player always re-rolls.

- **-r**

  Register with a meta server.  The meta server to use can be overriden with the **-m** option.

- **-s**

  Don't start the game immediately; wait for a command on the admin port (**-a**) instead.

- **-T \[0\|1\]**

  Choose a terrain type: *0* for the default, or *1* for random terrain.

- **-t** *mins*

  Tournament mode: add AI players after *mins* minutes.

- **-v** *points*

  Specify the number of "victory points" required to win the game.

- **-x**

  Automatically exit after a player has won.

## ENVIRONMENT

The default settings of the server can be influenced with the following three environment variables:

- **GNOCATAN\_META\_SERVER**

  The hostname of the meta-server when no meta-server is specified on the command-line.

- **GNOCATAN\_SERVER\_NAME**

  The hostname of the server. If it is not set, the hostname is determined by  **[hostname(1)](/hostname/1.md)**.

- **GNOCATAN\_DIR**

  The path to the game definition files. If it is not set, the default installation path will be used.

## FILES

**/usr/share/games/gnocatan/\*.game**

Game definitions

## AUTHOR

This manual page was written by Steve Langasek \<vorlon@debian.org\>,  and updated by Roland Clobus \<rclobus@bigfoot.com\>. Gnocatan was written by Dave Cole \<dave@dccs.com.au\>, Andy Heroff \<aheroff@mediaone.net\>, and Roman Hodek \<roman@hodek.net\>, with contributions from many other developers on the Internet; see the AUTHORS file in the gnocatan distribution for a complete list of contributing authors.

## SEE ALSO

**[gnocatan(6)](/gnocatan/6.md)**, **[gnocatan-server-gtk(6)](/gnocatan-server-gtk/6.md)**, **[gnocatanai(6)](/gnocatanai/6.md)**, **[hostname(1)](/hostname/1.md)**