[[Aranym]] is an X application. However, you may wish to run it headless for a buildd or on a remote server.

 * [[#dummy|dummy]]
 * [[#xvfb|xvfb]]
 * [[#vnc|vnc]]

<<Anchor(dummy)>>
= dummy =

Once you have networking and startup debugged, you can run aranym headless using the following command.

{{{SDL_AUDIODRIVER=dummy SDL_VIDEODRIVER=dummy aranym-mmu -l -c sid.config}}}

<<Anchor(xvfb)>>
= xvfb =

xvfb is easy to install and use. The downside is you'll need to do any console or network debugging beforehand.
{{{apt-get install xvfb
xvfb-run --auto-servernum aranym-mmu -l -c sid.config}}}

I'm not sure there is any advantage to this over using the dummy drivers.

<<Anchor(vnc)>>
= vnc =

vnc is a little more complicated to setup, but allows console access via any vnc client. I prefer vnc over ssh, so that's what this setup will show.

{{{apt-get install vnc4server}}}

My [[http://people.debian.org/~smarenka/aranym/vnc-aranym|vnc-aranym]] script essentially does this.

{{{
DISPLAY=1
NAME="aranym_host_name"
SIZE="640x480"
vncopts="--securitytypes=none --localhost"
vnc4server :$DISPLAY -name $NAME -geometry $SIZE $vncopts}}}
$DISPLAY needs to be unique for each vnc session. $NAME is handy for multiple vnc sessions and gets passed to .vnc/xstartup. Debian-installer seems to like SIZE="640x400" a bit better. The $vncopts are because I'm using ssh to handle encrypted remote access.

.vnc/[[http://people.debian.org/~smarenka/aranym/xstartup|xstartup]]:

{{{#!/bin/sh

# Uncomment the following two lines for normal desktop:
# unset SESSION_MANAGER
# exec /etc/X11/xinit/xinitrc

[ -x /etc/vnc/xstartup ] && exec /etc/vnc/xstartup
[ -r $HOME/.Xresources ] && xrdb $HOME/.Xresources
xsetroot -solid grey
vncconfig -iconic &

case "$VNCDESKTOP" in
        aranym_host_name)
                cd /srv/aranym && aranym-mmu -l -c config/$VNCDESKTOP >logs/$VNCDESKTOP 2>&1 &
                ;;
        *)
                xterm -geometry 80x24+10+10 -ls &
                ;;
esac
}}}

Where /srv/aranym/config has the aranym config file and logs is where the aranym output goes.

Then make sure that .vnc/xstartup is executable (chmod +x .vnc/xstartup).

So once you executed vnc-aranym, you may connect remotely to the vnc server (the aranym console) over ssh with the following.

{{{xvncviewer :1 -via aranym_host_name}}}