Hyperbox

Quick Start

Requirements:

• Git
• Java JDK 8+

Extra build requirements for Linux packages:

• makeself

Extra build requirements for Windows packages:

• nsis
• Launch4j

On Debian/Ubuntu, you may install all requirements except launch4j with:

$ sudo apt-get install git default-jdk-headless makeself nsis

If you have not installed Launch4j, you must download the software and install it in the /opt directory.

$ wget http://sourceforge.net/projects/launch4j/files/launch4j-3/3.14/launch4j-3.14-linux-x64.tgz/download?source=files -O ~/launch4j-linux-x64.tgz
$ sudo tar xf ~/launch4j-linux-x64.tgz -C /opt

To build Hyperbox binaries with client, server and all supported VirtualBox modules:

git clone https://github.com/hyperbox/hyperbox.git
cd hyperbox
./init
./gradlew build

You will then find the Client and Server binaries for Linux/Windows ready to be run as-is in the ./build/{client|server}/bin directory.

To start the server in foreground interactive mode, log to console (replace <OS>):

cd build/server/bin/<OS>
./hyperbox

To start the GUI client:

cd build/client/bin/<OS>
./hyperbox

Installation

You will find distribution packages in the Releases section

To build from source:

# For Linux
./gradlew distLinux

# For Windows
./gradlew distWin

# For all platforms
./gradlew distAll

You can then follow the regular instructions in the user manual.