_("You are the happy owner of an Internet Cube, but you do not know how to bootstrap it? This service was designed for you! After some questions about you, you will have to choose some settings, then to follow a quick installation guide.")

_("We assume that you have a VPN account with a fixed IP address and a supported hardware.")

_("Let's Go!")

_("About You")

_("Do you have a .cube file in the files provided by your VPN provider?") _(".cube file documentation")
_("Do not use a .cube file is a very bad idea... Are you an expert?")

_("Internet Cube and VPN providers")

_("You need help!")

_("If you do not have a supported hardware (LIME/LIME2) or a VPN account, or to do without .cube file, you should not use this service alone for now, and you should ask someone for some help. It is not a problem, because there are a lot of lovely people, from non-profit organizations, ready to help you :).")

_("You can choose a non-profit organization referenced on the map below, or try to find another one close to you (Linux User Groups, non-profit ISPs, etc). Be carefull when choosing your VPN provider, because you need to trust it more than your current ISP (you should try to meet the people doing it).")









_("Wifi Hotspot")


_("Wifi Hotspot")


_("Ready to Install!")

_("Installation Guide")

_("Sorry, but you cannot use the Installation Guide while you have issues to fix in the previous steps.")

_("Congratulations! You now just have to follow the Installation Guide, to install your Internet Cube.")

_("Download Cube File")

_("You cannot generate an HyperCube file, because you have some issues to fix in the previous steps. Instead, you just can download the Cube file corresponding to your VPN configuration (this file contains private keys and passwords):")

_("Download Cube File")

_("Step 1: Post-Installation")

_("You just have to do the post-installation, using your HyperCube file:")

  1. _("Put it on the root of a USB stick (not into a folder)")
  2. _("Unplug your Internet Cube from the outlet if powered on")
  3. _("Plug your USB stick (1) and your wifi dongle (2) to your Internet Cube")
  4. _("Then connect the ethernet cable (3), then the power cable (4)")
  5. _("Finally, plug the ethernet cable to your router, then the power cable into an outlet")
Internet Cube Cables

_("Step 2: You Got a New Wifi!")

_("Wait for something like a few dozen minutes, without unplugging the cables.") _("Once you can see your new wifi access point from your computer, this means that your Internet Cube is ready and that you can use it. Connect your computer to the new wifi access point.")

_("Congratulations, you now have a clean Internet access!") _("You can remove the USB stick (1) from your Cube.")

_("If you do not see your new wifi access point after several dozen minutes, you should ask someone for some help. You can also try to follow the How to Debug The Installation? section at the end of this guide.")

_("Step 3: DNS Configuration")

_("For being able to use the self-hosting features of your Cube, you have to configure your domain name, on the registrar side. But, because you have not filled out the IPv4 Assigned Address field in the VPN step, your DNS Configuration can not be generated here. Please, fill out this field and go back here, or get help from a non-profit organization.")

_("You have no DNS configuration to do, because you chose a domain ending by nohost.me or noho.st. However, you should do the steps described above quickly, because your domain will only be registered during your Cube installation.")

_("For being able to use the self-hosting features of your Cube, you have to configure your domain name, on the registrar side. Please, click on the registrar you chose for your domain name (if yours is not listed, please get help from a non-profit organization):")

  • OVH
    1. _("Go to your OVH manager:") https://www.ovh.com/manager/
    2. _("Sign in, using your OVH Account ID (should be something like aa0000-ovh)")
    3. _("Click on your domain name, in the list on the left") ()
    4. _("Click on the tab:") _("DNS Zone")
    5. _("On the right, click on the button:") _("Change in text format")
    6. _("In the text area, keep only the 4 first lines (SOA + NS) and delete the other ones")
    7. _("Then, at the end of the text area, add these ones:")
    8. _("Click on Next, then Confirm")
  • Gandi.net
    1. _("Go to your Gandi.net account:") https://www.gandi.net/login
    2. _("Sign in, using your Gandi.net Handle (should be something like AA0000-GANDI)")
    3. _("Click on your domain name, in the list") ()
    4. _("At the bottom right, under Zone files, click on the link:") _("Edit the zone")
    5. _("In the warning bubble, click on the blue button:") _("Create a new version")
    6. _("At the left, change the Edit mode to Expert")
    7. _("In the text area, replace all by:")
    8. _("Above, click on the blue button:") _("Use this version")
    9. _("In the popup, click on Submit")

_("Step 4: Self-Hosting")

_("If you want to update your settings, add accounts, add email addresses or configure some web services to host, you just have to access the web administration, named YunoHost (you will have to accept the security exception proposed by your browser):")

_("If you want to access to your current apps, go to:")

_("You first email address (which also is a Jabber ID) is:")

_("You can already use it, using the Roundcube Webmail app, available through the link above!")

_("If you want to configure your mailbox on your smartphone (e.g. using K-9 Mail), you can use these settings:")

  • _("Email address:")
  • _("Password:") _("Show")
  • _("Account type:") IMAP
  • _("Incoming server settings:")
    • _("Username:")
    • _("Password:") _("Show")
    • _("IMAP server:")
    • _("Security:") _("SSL/TLS (always)")
    • _("Authentication:") _("PLAIN")
    • _("Port:") 993
  • _("Outgoing server settings:")
    • _("Username:")
    • _("Password:") _("Show")
    • _("SMTP server:")
    • _("Security:") _("SSL/TLS (always)")
    • _("Authentication:") _("PLAIN")
    • _("Port:") 465

_("If you experience problems using the web administration, please read the YunoHost Documentation, or ask for some help to a non-profit organization:")

_("Documentation") / _("Getting Help")

_("A Word About Security")

_("1) Your Cube/HyperCube files contain private keys and passwords. Keep them secret and never provide them to anyone.")

_("2) A Cube is just a computer, so keep in mind that it can die any time. Therefore, if you use it for self-hosting, be sure to make regular backups of your data (emails, files, etc).")

_("How to Properly Power Off my Cube?")

_("Whenever possible, do not disconnect the power supply from your Internet Cube, without having first switched it off (otherwise, this could lead to database errors). For turning off your Internet Cube, just quick press the bottom-left button, using a pen. Then, wait until all the lights are turned off (especially the orange one, close to the ethernet cable, on the opposite side). You now can disconnect the power supply.")

Powering Off a Cube

_("How to Debug The Installation?")

_("Sometimes, things go wrong... To help you to debug, you can follow what your Cube is doing, during the installation process (i.e. the first time you plug your Cube after following this guide).")

_("For that, follow these instructions (you maybe will have to ask for help to someone):")

  1. _("Be sure to have waited long enough. If you have waited for a few dozen minutes and you do not see your new wifi access point (step 3), continue to follow these instructions.")
  2. _("Find the HTTP address of the HyperCube Debug interface, using the SD Card Installer on your computer with Debian or Ubuntu, this way:")
    % bash install-sd.sh -l
  3. _("Open this HTTP address with your web browser.")
  4. _("Wait until you think the installation is finished or aborted, if the interface is still connected.")
  5. _("Save the HTML file with Ctrl+S.")
  6. _("You can now provide it to someone able to help you, and find with her/him what is wrong.")

_("If you powered on your Cube 4 hours (or more) ago, or you have rebooted it since, the HyperCube Debug interface is no longer available. You need before to unplug your Cube and start again to follow this guide, from step 1 to step 3 (assuming your Cube is not - or no longer - pre-installed).")

_("Tip: You also can plug an USB stick to your Cube before powering it on, and retrieve all logs on the stick from the time when the installation is finished or aborted.")