doc/install_on_olinuxino.md

Install on an OlinuXino board

The simplest way to install YunoHost on an OLinuXino board is to use the image provided by the [*Internet Cube project*](http://labriqueinter.net). It's an image specifically designed for the OLinuXino boards.

If you aim to setup a full Internet Cube (OLinuXino boad + YunoHost + VPN from neutral ISP + Wifi access point), you should contact your [local associative ISP](https://internetcu.be/#obtenir-une-brique), the Internet Cube really advice **against** installing it yourself. If you still really want to do it by yourself, you can try [the install procedure on the Internet Cube project website](https://install.labriqueinter.net).

It is recommended to read about the advantages of using a neutral VPN in the context of self-hosting and to contact your local associative ISP (if you have one).

Prerequisites

• One of these OLinuXino boards
• A20-OLinuXino-LIME
• A20-OLinuXino-LIME2
• A Micro-SD card (Transcend 300x show good performance and stability).
• A power supply (european one) for the board. (Supply through a USB cable is not stable.)
• An ethernet/RJ-45 cable to connect the board to your internet box / router.

To prepare the SD card, a computer with GNU/Linux or BSD is preferable. You should be able to follow the same instructions on MacOS/OSX. On Windows, you will need to use the tool decribed here.

---

Download the image

Download the image (LIME1 or LIME2), check its integrity (MD5 checksum), and uncompress it :

cd /tmp/
# Download image
wget https://repo.labriqueinter.net/labriqueinternet_A20LIME_latest_jessie.img.tar.xz

# Integrity check (optionnal, but recommended)
wget -q -O - https://repo.labriqueinter.net/MD5SUMS | grep "labriqueinternet_A20LIME_latest_jessie.img.tar.xz$" > MD5SUMS
md5sum -c MD5SUMS

# Uncompress image
tar -xf labriqueinternet_*.img.tar.xz
mv labriqueinternet_*.img labriqueinternet.img

Copy image to SD card

1. Identify the name of the card :

   • Make sure the SD card is not plugged in the computer
   • Run the command ls -1 /sys/block/
   • Insert the SD card in the computer (maybe
   • Run the command ls -1 /sys/block/ again
   • The name of your card (SDNAME) is the one present in the what's returned in the second command but not in the first. It's usually something like sdb or mmcblk0.

2. Copy the image to your card (replace SDNAME by the name of your card, found in the previous step). Command will take a while.

sudo dd if=/tmp/labriqueinternet.img of=/dev/SDNAME bs=1M status=progress
sync

Plug and boot

Insert the card in the OLinuXino board, connect it to your router with the Ethernet cable, and plug the power supply. Your board will boot (give it a few seconds) and the LEDs around the Ethernet port should start blinking.

The first boot can take a little more than one minute because the partition is being resized and the board rebooted automatically.

Find the local IP of your server

Get the local IP of your OLinuXino board :

• either using sudo arp-scan --local | grep -P '\t02' ;
• either using the router interface by listing the DHCP clients ;
• either by pluging an HDMI screen on the OLinuXino, logging in and typing ifconfig.

In the following commands, we refer to the board's IP with **192.168.x.y**. You should replace it with the local IP you found.

Connect through SSH and change root password

Connect to your server with

ssh root@192.168.x.y

The default password is olinux.

After connecting, you will be asked to changed the root password. First, enter olinux again (current password), then type the new password two times.

Update your server

Update your server with the following commands. It can take around 15 minutes.

apt update && apt dist-upgrade

Proceed to post-installation

Proceed to post-installation by connecting with your browser to https://192.168.x.y (you browser will warn you about the certificate being self-signed, but you can add/accept the certificate exception).

**Note :** it is also possibled to do the post-installation step through command line in SSH, with `yunohost tools postinstall`.

(Optional) Install DoctorCube

If you want to benefit automatically from fixes and configuration specific to the Internet Cube, you can install the DoctorCube app.

1. Add the Internet Cube repository :

yunohost app fetchlist -n labriqueinternet -u https://labriqueinter.net/apps/labriqueinternet.json

2. In the web administration interface, click on "Applications", then install the DoctorCube app. The installation can be pretty long, but you can leave the page anyway.