This page is for experts only. If you are interested by a plug-n-play Internet Cube, please contact a non-profit organization. If you have purchased the suggested hardware by yourself, or an organization have provided you a pre-installed Internet Cube, you should use the automatic installation guide.
Informations about the way we build the Debian/YunoHost images are available at build.labriqueinter.net. You can rebuild images by yourself if you want.
Download the SD Card Installer, and just run it (add -2 at the end for a LIME2, or -h to see other options):
% bash install-sd.sh
For the SSH access and the YunoHost post-installation, see the Post-Installation section below.
Quick Guide (encrypted)
The creation of cubes with an encrypted filesystem is currently not supported anymore. Contact the development team if you wish to help on this topic.
To finalize the Cube configuration, log in once it booted on the card. Use the installation script to scan your local network and find the Cube IP:
% bash install-sd.sh -l
Once your Cube found, connect with SSH on port 22:
Note: If there is only one Cube on your network, you can also directly use
ssh root@fe80::42:acab%eth0 (replacing eth0 by the network device you use on your computer).
The first thing to do is upgrading Debian/Yunohost:
% sudo apt-get update && sudo apt-get dist-upgrade
You can now do the YunoHost post-installation.
Then, add the list of community apps to YunoHost:
% yunohost app fetchlist -n community -u https://app.yunohost.org/community.json
From the YunoHost web administration, you can now install the VPN Client and Wifi Hotspot apps, then configure them.
The recommended installation method consists in using an hypercube file generated from this page.
The hypercube file can be fed to the
install-sd.sh script in the following way:
% bash install-sd.sh -y install.hypercube
If the file was not fed to the
install-sh.sh, it is still possible to plug an USB key (formated in NTFS or FAT32) on the cube with the file on it to trigger the install automatically.
The installation procedure can be followed from the web interface accessible at
Or it is possible to detect automatically the debug interface available on the local network using this tool.