- Technical documentation
- API docs
Running Spaceify in VirtualBox
This guide shows you how to run Spaceify in a virtual machine using VirtualBox. This is the recommended method of installing Spaceify for all uses except commercial deployment. If you follow this guide, you will have Spaceify running inside a virtual machine on your computer. Even though this guide aims at creating a virtual Spaceify network, moving on to using real WiFi devices is simple, and it is documented in the tutorial "connecting real WiFi devices to the Spaceify virtual machine".
Download and install the latest VirtualBox AND VirtualBox Extension Pack from https://www.virtualbox.org/wiki/Downloads.
Download and Install Spaceify Virtual Appliance
The latest Spaceify virtual machine image can be downloaded as a VirtualBox virtual appliance in the .ova format from http://www.hiit.fi/software/spaceify/virtualedge.ova. This virtual machine image contains a 64-bit Ubuntu 14.04 LTS Server with all the Spaceify components preinstalled and ready to run. Download the latest Spaceify virtual machine image and import it into VirtualBox by using the menu item "File/Import appliance…"
Add two Host-Only Networks to VirtualBox
The .ova format does not unfortunately allow the saving global VirtualBox preferences, so you need to make one change in the preferences to get the Spaceify virtual appliance working. In VirtualBox, go to "VirtualBox/Preferences…/Networks/Host-only Networks". Now add two host-only networks. Make sure the addresses of the new host-only networks are 192.168.56.1 and 192.168.57.1 (they should be like this by default). The first host-only network is meant for communication between the host operating system and the Spaceify virtual machine and the second one emulates the Spaceify wireless network.
Start the Spaceify Virtual Appliance
Start the virtual appliance by clicking the "Start" arrow in the main Window of VirtualBox. Spaceify virtual machine should now start and boot to the Ubuntu "login" screen. You can log in to the virtual machine using the user name "spaceify" and password "spaceify123". If you want to use your own terminal instead of the VirtualBox one, you can also connect to the virtual machine with ssh at address 192.168.56.2.
Configure the Socks Proxy Settings of Your Web Browser
In order to see the web the way Spaceify clients see it, you need to configure your web browser to use the socks proxy server of the Spaceify virtual machine. Configure your web browser to use sock proxy at 192.168.56.2 port 1080. In the screenshot below you can see how this is done in the Firefox. Read more about DNS lookup from here.