- Technical documentation
- API docs
Notice Spaceify is intended to be run on a dedicated edge node computer. We recommend to do a system backup, before Spaceify is installed to "home" or "office" computer. Install Spaceify at your own discretion.
Spaceify currently runs on Ubuntu 16.04.x operating system. The amount of required memory, CPU power, or hard drive space is not specified. Spaceify requires two network adapters. One of the adapters is required for internet traffic and the other for clients connecting to the Spaceify Edge computer. Typical configuration is to have ethernet and wireless (Wi-Fi) adapters. The client connection can be provided by internal wireless adapter or external wireless router.
Notice Spaceify's installation turns the computer into a wireless access point with open network.
Below on the image are possible networ configurations.
Spaceify's Debian package is available in Spaceify's repository. Before Spaceify itself can be installed, there are some prerequisities to install. Installing them is required only when Spaceify is installed for the first time. Updating does not require the reinstallation of the prerequisities.
$ sudo wget -O - http://spaceify.org/initialize | bash
Install or update Spaceify.
$ sudo apt-get install spaceify
The installation process takes few minutes. There are some questions asked during the installation.
Select the network adapter that is connected to Internet.
Usually this is the wireless network adapter, ike eth0.
Select the network adapter that the Spaceify clients will connect to. This can be either an internal WLAN adapter or a wired adapter that is directly connected to an external wireless access point.
Select the appropriate wireless or wireless connected adapter.
Is the network adapter the Spaceify clients will connect to an internal WLAN adapter or a wired adapter connected to an external wireless access point.
If internal wireless adapter (for example, wlan0) was selected in Question 2, select "Internal". If the wireless connection is external, like a Wi-Fi router, select "External".
Create an admin password for this Spaceify edge node.
The password is used in administrative actions performed from Spaceify's web page. For example, logging into Spaceify AppStore requires the password.
When Spaceify is installed, an unique registration identifier is creted for it. This identifier is stored to Spaceify's cloud and is used there to differentiate installations. The identifier is used, for example, with Spaceify's remote operation system. The identifier is also stored as a file to Spaceify's installation directory.
The file can be saved for later use. If Spaceify's installer finds the file from
it uses the same registration. This way the registration and all the associations linked to it are retained.
Removing Spaceify's installation
$ sudo apt-get purge spaceify
Complete removal of dependencies after Spaceify is removed.
$ sudo apt-get atoremove