Installation on a server (experts only)
What follows are detailed instructions for installing z-Tree unleashed on your own server. We recommend the use of Debian.
Only do this if you are a Linux aficionado. If you are not, use our simple installation instructions using the virtual machine image (which can also be used on a server) or ask your local Linux guru to do this for you. Using these instructions while not being a Linux aficionado may have grave consequences, and there is no warranty.
-
Login to your server as
root
and create the userlab
:root@zunleashed ~ % adduser lab
Set a secure password for lab:
root@zunleashed ~ % passwd lab
-
Install required and suggested packages:
root@zunleashed ~ % echo 'deb http://deb.debian.org/debian buster-backports main contrib non-free' > /etc/apt/sources.list.d/buster-backports.list root@zunleashed ~ % dpkg --add-architecture i386 root@zunleashed ~ % apt update root@zunleashed ~ % apt install git wine wine32 wireguard ssl-cert nginx psmisc sudo tmux root@zunleashed ~ % apt install xtightvncviewer x11vnc xvfb vinagre i3 xdotool root@zunleashed ~ % apt install netcat-openbsd rsync htop geany zip root@zunleashed ~ % ln -s /usr/bin/python3 /usr/bin/python 2>/dev/null root@zunleashed ~ % echo wireguard > /etc/modules-load.d/wireguard.conf
-
Add
lab
to the sudoers file:root@zunleashed ~ % echo "lab ALL=(ALL) NOPASSWD: ALL" | tee -a /etc/sudoers
This enables sudo passwordless authentication for the
lab
user. Make sure that only authorized personnel has access to thelab
user. -
Log in as
lab
, clone this repository and set up some symbolic links:root@zunleashed ~ % su - lab lab@zunleashed ~ $ git clone https://gitlab.com/cler1/ztree-unleashed lab@zunleashed ~ $ ln -s ztree-unleashed/scripts scripts lab@zunleashed ~ $ ln -s ztree-unleashed/utils utils
If you use Debian or a broadly compatible system such as Ubuntu and wish to enable automatic installation of configuration files, please execute the following:
lab@zunleashed ~ $ sudo touch /etc/zu_oem
-
Initialize z-Tree unleashed:
lab@zunleashed ~ $ cd scripts lab@zunleashed ~/scripts $ ./init.sh
-
You are essentially done. We recommend that you put the z-Tree and z-Leaf executables into
/share/zTree
. For example, you can use a web browser to download files. But you could also use rsync or SFTP (e.g. using Filezilla). -
You can run a session like this:
lab@zunleashed ~ $ cd scripts lab@zunleashed ~/scripts $ ./start_session_simple.sh
This document is still a work-in-progress.
- Previous
- Next