- 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 VirtualBox IMAGES. This virtual machine image contains a 64-bit Ubuntu 16.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…".
Notice The screenshots are from the Machintosh version of VirtualBox and might look different on other platforms. Furthermore, other versions might have different appearance. The locations of the settings might also vary from version to version.
Add two Host-Only Networks to VirtualBox
The .ova format does not unfortunately allow the saving of 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" or "File /Host Network Manager…". Now add/create 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.
The network adapters names are "vboxnet0" / "vboxnet1", "VirtualBox Host-Only Ethernet Adapter" / "VirtualBox Host-Only Ethernet Adapter #2", or similar depending on your host operating system.
Before proceeding, make sure the network adapters are selected in the Spaceify Edge's virtual machine settings. Select the "SpaceifyEdge" image from the left (do not double click) and click the "Settings" icon on the top toolbar. From the opened settings dialog select "Network". Make sure the first three "Adapters" are enabled. Next check the "Attached to" and "Name" settings.
- no name
- Host-Only adapter,
- "vboxnet0", "VirtualBox Host-Only Ethernet Adapter", or similar
- Host-Only adapter,
- "vboxnet1", "VirtualBox Host-Only Ethernet Adapter #2", or similar
Start the Spaceify Virtual Appliance
Start the virtual appliance by clicking the "Start" arrow on the top toolbar or double click the "SpaceifyEdge" image. 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.