OpenArena dedicated server for Debian
=====================================

Running the server via the init script
--------------------------------------

The openarena-server init script runs a dedicated server as the user
"Debian-openarena". This is a simple setup suitable for running one server
on a machine; by default it will run a deathmatch server.

The Debian-openarena user's home directory is /var/games/openarena-server,
so you can find OA files in the /var/games/openarena-server/.openarena
directory.

By default, the init script will use
/usr/lib/games/openarena/baseoa/debian_server.cfg, which is a symlink to
/etc/openarena-server/server.cfg. You can edit this file, or put an alternative
configuration in /var/games/openarena-server/.openarena/baseoa and change
/etc/default/openarena-server to exec that.

Disabling the init script
-------------------------

To disable the init script, use the facilities provided by your init system.
For instance, under sysvinit, use

    update-rc.d openarena-server disable

or under systemd, use

    ln -s /dev/null /etc/systemd/system/openarena-server.service

Changing the value of the START_DAEMON variable in
/etc/default/openarena-server is deprecated. Please leave it set to
"unless-disabled-by-upgrade".

Running the server with cron and screen
---------------------------------------

One alternative way to run the server is to run it in a screen(1) session
from a cron @reboot action. This can be used to run multiple instances
of the server; you'll need to set a different net_port on each server after
the first, and it's safest to give each server a unique fs_homepath so they
don't overwrite each other's configuration files.

To do this, you could put something like this in the Debian-openarena user's
crontab (don't break the long lines!):

    @reboot screen -d -m -S ffa /usr/games/openarena-server +set fs_homepath /var/games/openarena-server/ffa +exec ffa.cfg
    @reboot screen -d -m -S ctf /usr/games/openarena-server +set fs_homepath /var/games/openarena-server/ctf +set net_port 54321 +exec ctf.cfg

or in /etc/crontab or a file in /etc/cron.d:

    @reboot Debian-openarena screen -d -m -S ffa /usr/games/openarena-server +set fs_homepath /var/games/openarena-server/ffa +exec ffa.cfg
    @reboot Debian-openarena screen -d -m -S ctf /usr/games/openarena-server +set fs_homepath /var/games/openarena-server/ctf +set net_port 54321 +exec ctf.cfg

If you do that, you can access the servers' consoles by attaching a screen
session to them:

    sudo -u Debian-openarena screen -r ffa
    sudo -u Debian-openarena screen -r ctf