This README deals with the virtual X11 screens for jails.

JailTools support virtual X11 screens using VNC, in particular Xvnc.

You need a up-to-date port-tree, then following steps are required:

   mkdir -p /usr/ports/packages
   cd /usr/ports/net/vnc && make install package clean

Now /usr/ports/packages/All/vnc*.tgz is done.

light-install jails: 
   nothing more to do as /usr is shared from jail-host so
   all applications installed on the jail-host are available
   to the light-installation of a jail
   
full-install jails:
   copy the vnc*.tgz into /usr/jails/IP_of_jail/tmp/, and then start
   the particular jail (e.g. jail_start IP_of_jail), then login
   into the jail, and call
      pkg_add /tmp/vnc*.tgz
   now you have VNC package installed in your jail.

Then edit your jail.conf, add a line like
   jailconfig_alpha="ip 192.168.0.100 x11 800x600 depth 24"

then you can install & start it, e.g.
   jail_install alpha
   jail_start alpha /etc/rc
   
NOTE: only via /etc/rc the Xvnc is properly started.

Then you can connect the Xvnc with vncviewer, e.g.
   vncviewer 192.168.0.100     or
   vncviewer alpha             (when your DNS maps the IP to this alias)

or even your web-browser (with java enabled):
   http://192.168.0.100:5800/  or
   http://alpha:5800/          (when your DNS maps the IP to this alias)
   
One feature which is enabled by default is that you can connect
simulatenously with different vncviewers.


-- Rene K. Mueller, 02/2004