Merge pull request #442 from YunoHost/fix-olimex-setup

[enh] Add a documentation dedicated to olinuxino

install_on_olinuxino.md

@@ -0,0 +1,111 @@
+# Install on an OlinuXino board
+
+<div class="alert alert-info" markdown="1">
+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.
+</div>
+
+<div class="alert alert-warning" markdown="1">
+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](/vpn_advantage) and to contact your local associative ISP (if you have one).
+</div>
+
+## Prerequisites
+
+* One of these OLinuXino boards
+ * [A20-OLinuXino-LIME](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/open-source-hardware)
+ * [A20-OLinuXino-LIME2](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME2/open-source-hardware)
+* A Micro-SD card ([Transcend 300x](https://www.amazon.com/Transcend-MicroSDHC-Class10-Adapter-TS32GUSDU1/dp/B00APCMMDG/) show good performance and stability).
+* A power supply ([european one](https://www.olimex.com/Products/Power/SY0605E/)) 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](/copy_image).
+
+---
+
+## Download the image
+
+Download the image ([LIME1](http://repo.labriqueinter.net/labriqueinternet_A20LIME_latest_jessie.img.tar.xz) or [LIME2](http://repo.labriqueinter.net/labriqueinternet_A20LIME2_latest_jessie.img.tar.xz)), check its integrity (*MD5 checksum*), and uncompress it :
+```bash
+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.
+```bash
+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.
+<div class="alert alert-warning" markdown="1">
+The first boot can take a little more than one minute because the partition is being resized and the board rebooted automatically.
+</div>
+
+## 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`.
+
+<div class="alert alert-info" markdown="1">
+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.
+</div>
+
+## Connect through SSH and change root password
+
+Connect to your server with
+```bash
+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.
+```bash
+apt-get update && apt-get dist-upgrade
+```
+
+## Proceed to post-installation
+
+Proceed to [post-installation](/postinstall) 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).
+<div class="alert alert-info" markdown="1">
+**Note :** it is also possibled to do the post-installation step through command line in SSH, with `yunohost tools postinstall`.
+</div>
+
+## (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 :
+```bash
+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.
+
+

install_on_olinuxino_fr.md

@@ -0,0 +1,107 @@
+# Installation sur une carte OlinuXino
+
+<div class="alert alert-info" markdown="1">
+Pour installer YunoHost sur une carte OLinuXino, le plus simple est d'utiliser l'image du projet [Site du projet *La Brique Internet*](http://labriqueinter.net). Il s'agit d'une image YunoHost qui est actuellement spécifiquement destinée aux cartes OLinuXino.
+</div>
+
+<div class="alert alert-warning" markdown="1">
+Si vous souhaitez mettre en place ou obtenir une Brique Internet complète (Carte Olimex + YunoHost + VPN associatif neutre + Hotspot Wifi), nous vous conseillons de contacter [le FAI associatif le plus proche de chez vous](https://labriqueinter.net/#obtenir-une-brique), la Brique Internet déconseillant **fortement** de faire l'installation vous-même. Si vous voulez néanmoins le faire, vous pouvez utiliser [la procédure d'installation du projet La Brique Internet](https://install.labriqueinter.net).
+
+Pour faire votre choix, nous vous conseillons de rencontrer votre FAI associatif local et de consulter [les avantages d'un VPN neutre dans le cadre de l'auto-hébergement](/vpn_advantage_fr).
+</div>
+
+## Prérequis
+
+Le matériel nécessaire :
+* Un mini-serveur Olimex :
+ * [A20-OLinuXino-LIME](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/open-source-hardware)
+ * [A20-OLinuXino-LIME2](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME2/open-source-hardware)
+* Une carte micro-SD (des [Transcend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO) pour des raisons de performance/stabilité).
+* Un adaptateur secteur [européen](https://www.olimex.com/Products/Power/SY0605E/) pour alimenter la carte olimex. L’alimentation via USB semble peu stable.
+* Un câble Ethernet/RJ-45 pour brancher la Brique à son routeur.
+
+Pour préparer la carte SD, un ordinateur sous GNU/Linux ou BSD est préférrable. Vous devriez pouvoir suivre les mêmes instructions avec MacOS/OSX. Sous Windows, il vous faudra utiliser l'outil décrit [ici](/copy_image_fr).
+
+---
+
+## Télécharger l’image
+
+Télécharger l’image ([lime1](http://repo.labriqueinter.net/labriqueinternet_A20LIME_latest_jessie.img.tar.xz) ou [lime2](http://repo.labriqueinter.net/labriqueinternet_A20LIME2_latest_jessie.img.tar.xz)), vérifier son intégrité (somme de contrôle MD5), puis la décompresser :
+```bash
+cd /tmp/
+# Télécharger l'image
+wget https://repo.labriqueinter.net/labriqueinternet_A20LIME_latest_jessie.img.tar.xz
+
+# Verifier l'intégrite (optionel, mais recommandé)
+wget -q -O - https://repo.labriqueinter.net/MD5SUMS | grep "labriqueinternet_A20LIME_latest_jessie.img.tar.xz$" > MD5SUMS
+md5sum -c MD5SUMS
+
+# Décompresser l'image
+tar -xf labriqueinternet_*.img.tar.xz
+mv labriqueinternet_*.img labriqueinternet.img
+```
+
+## Copier l’image sur la carte SD
+
+1. Identifier le nom de la carte micro-SD : 
+   - Assurez-vous que la carte n'est *pas* insérée dans l'ordinateur
+   - Tapez `ls -1 /sys/block/`
+   - Insérez la carte
+   - Retaper `ls -1 /sys/block/`
+   - Le nom de la carte correspond au nom qui apparaît en plus dans la deuxième commande. Il s'agit généralement de quelque chose comme `sdb` ou `mmcblk0`.
+
+2. Copier l’image sur la carte (remplacer *SDNAME* par le nom trouvé lors de l’étape précédente). La copie peut prendre un certain temps.
+```bash
+sudo dd if=/tmp/labriqueinternet.img of=/dev/SDNAME bs=1M status=progress
+sync
+```
+
+## Brancher & démarrer
+
+Insérer la carte micro-SD dans la carte OLinuXino, connecter la carte OLinuXino à votre routeur avec le câble Ethernet, puis brancher l’alimentation. La carte démarre normalement toute seule, et les LEDs du port Ethernet se mettent à clignoter au bout de dix secondes maximum.
+<div class="alert alert-warning" markdown="1">
+Le premier démarrage peut prendre un peu plus d’une minute car la partition est redimensionnée et le serveur est redémarré automatiquement.
+</div>
+
+## Trouver l'ip locale de votre mini-serveur
+Récupérer l’adresse IP locale :
+
+ * soit avec une commande comme `sudo arp-scan --local | grep -P '\t02'`;
+ * soit via l’interface du routeur listant les clients DHCP ;
+ * soit en branchant un écran en HDMI au mini-serveur, et en exécutant `ifconfig`.
+
+<div class="alert alert-info" markdown="1">
+Pour les commandes suivantes, nous utiliser **192.168.x.y** pour désigner l'IP du serveur. Remplacez-la par l’adresse IP déterminée précédemment.
+</div>
+
+## Changer le mot de passe root en se connectant en SSH
+
+Se connecter en SSH en root au mini-serveur, le mot de passe par défaut est **olinux** :
+```bash
+ssh root@192.168.x.y
+```
+À la première connexion, il sera demandé de changer le mot de passe : entrer à nouveau **olinux**, puis saisir deux fois le nouveau mot de passe.
+
+## Mettre à jour le serveur
+
+Mettre à jour le système (environ 15 minutes) :
+```bash
+apt-get update && apt-get dist-upgrade
+```
+
+## Procéder à la postinstallation
+
+Procéder à la [postinstallation](/postinstall_fr) en se connectant à la carte avec votre navigateur web sur https://192.168.x.y (votre navigateur vous avertira que le certificat est auto-signé, ceci est normal : vous pouvez ajouter une exception de sécurité pour ce certificat).
+<div class="alert alert-info" markdown="1">
+**Note :** il est également possible de réaliser la post-installation ligne de commande via SSH en exécutant `yunohost tools postinstall`.
+</div>
+
+## (Optionel) Installer DoctorCube
+
+Si vous souhaitez bénéficier automatiquement des corrections de l'image du projet La Brique Internet, vous pouvez installez l'application dédiée DoctorCube.
+
+1. Ajoutez le dépôt d'application du projet La Brique Internet
+```bash
+yunohost app fetchlist -n labriqueinternet -u https://labriqueinter.net/apps/labriqueinternet.json
+```
+2. Dans l'administration web, cliquez sur la catégorie "Applications", puis installez l'application DoctorCube qui fournie des configurations et des fixs spécifiques à la brique. L'installation de DoctorCube peut prendre de nombreuses minutes. Vous n'êtes pas obligé de rester sur la page web.

sitemap.md

@@ -16,6 +16,7 @@
         * [Installation guide](/install)
             * [On the Internet Cube](/install_brick_en)
             * [On an ARM board](/install_on_arm_board)
+            - [On an Olimex board](/install_on_olinuxino)
             * [On a Raspberry Pi](/install_on_raspberry)
             * [From an ISO](/install_iso)
             * [On Debian](/install_on_debian)
@@ -40,6 +41,7 @@
            * [Dynamic IP address: configure DynDNS](dns_dynamicip_en)
            * [Access his server on his local network](/dns_local_network_en)
 	   - [IPv6](ipv6_fr)
+           - [VPN](vpn_advantage)
         * [Internet service provider](/isp)
             * [Generic configuration of the ISP router](/isp_box_config)
         * Applications

sitemap_fr.md

@@ -16,6 +16,7 @@
         * [Guide d’installation](/install_fr)
             * [Sur la Brique Internet](/installation_brique_fr)
             * [Sur carte ARM](/install_on_arm_board_fr)
+            - [Sur carte Olimex](/install_on_olinuxino_fr)
             * [Sur Raspberry Pi](/install_on_raspberry_fr)
             * [À partir de l’ISO](/install_iso_fr)
             * [Sur Debian](/install_on_debian_fr)
@@ -43,6 +44,7 @@
             * [Accéder à son serveur dans son réseau local](/dns_local_network_fr)
             * [Nom de domaine en Nohost.me](/dns_nohost_me_fr)
 	    - [IPv6](ipv6_fr)
+	    - [VPN](vpn_advantage_fr)
         * [Fournisseurs d’accès à Internet](/isp_fr)
             * [Configuration générique de la box ou du routeur](/isp_box_config_fr)
             * [Free](/isp_free_fr)

vpn_advantage_fr.md

@@ -0,0 +1,46 @@
+# Avantage d’un VPN pour l’auto-hébergement
+
+L'installation d'un serveur chez soi étant une pratique peu courante, la plupart des connexions Internet fournies aux particuliers sont inadaptées à sa mise en pratique. Un VPN respectant la neutralité du net et fournissant une adresse IPv4 fixe et des adresses IPv6 peut permettre de contourner certaines limitations ou certaines difficultés.
+
+<div class="alert alert-warning">
+<b>Attention</b> : tous les fournisseurs VPN existants ne remplissent pas ces conditions, assurez-vous bien que celui que vous choisissez les remplis.
+</div>
+
+## Avantages
+
+### Plug & Play
+En configurant un VPN sur votre serveur, vous serez en mesure de le rendre accessible au reste d'Internet sans avoir à modifier la configuration du routeur auxquel vous le branchez. Ce point peut être vraiment pratique si vous partez en vacances, que vous déménagez ou que vous ayez une coupure d'Internet car vous serez en mesure de le brancher facilement chez une personne de confiance sans avoir besoin de configurer le routeur de la personne qui vous aide.
+
+De la même façon, vous vous économisez l'ouverture des ports de votre routeur ainsi que le coutournement du hairpinning.
+
+### Pas de micro-coupure DNS
+Si votre connexion Internet n'a pas d'IP publique fixe, vous serez obligé de mettre en place un nom de domaine dynamique (Dynamique DNS). Cette solution peut être acceptable, mais la mise à jour du DNS ne se fera qu'à intervalle régulier (Toutes les deux minutes si c'est un nom de domaine en `noho.st` ou `nohost.me`). Il y a donc une chance que cela provoque de temps en temps des erreurs d'affichage dans le navigateur, voir même qu'un autre site s'affiche (les risques sont toutefois réduit car la pratique de l'auto-hébergement n'est pas répandue).
+
+Avec un VPN neutre, ce problème est contourné car le VPN peut être comparé à une connexion Internet Virtuelle, qui a sa propre adresse IPv4 fixe, dès lors plus besoin de mettre à jour le nom de domaine. 
+
+### Le cas du mail
+Le mail est un des protocoles les plus complexes à auto-héberger, en général c'est ce qu'un utilisateur auto-héberge en dernier. En effet, il est très facile de se retrouver dans une situation où les emails envoyés par le serveur sont refusés par les serveurs SMTP destinataires.
+
+Pour éviter ça il faut entre autre :
+- configurer le reverse DNS de la connexion Internet (ou du VPN) du serveur
+- une IPv4 fixe
+- que cette IPv4 soit enlevable de toutes les listes noire (notamment l'IP ne doit pas être sur le DUL)
+- pouvoir ouvrir le port 25 (ainsi que les autres ports SMTP)
+
+Malheureusement, aucun des FAI français les plus courants ne respecte la totalité de ces points.
+
+Pour pallier à ça, l'usage d'un VPN respectant ces points peut être une alternative.
+
+### Confiance
+Enfin, si vous ne souhaitez pas que le contenu des communications de votre serveur soit espionnable par des équipements présent sur le réseau de votre Fournisseur d'Accès Internet, vous pouvez utiliser un VPN pour chiffrer vos communications et déporter votre confiance sur un fournisseur de VPN. Rappel, depuis 2015, le gouvernement déploie officiellement des boîtes noires chez les gros opérateurs réseau qui ont pour objectif de mettre sur écoute l'ensemble des communications numériques françaises entre autre pour préserver les intérêts scientifiques, économiques et industrielles de la France.
+
+## Inconvénient
+### Coût
+Un VPN neutre a un coût puisque l'opérateur qui le fournis doit faire fonctionner un serveur et utiliser de la bande passante. Les prix des VPN associatifs de la FFDN sont autour de 6 € par mois.
+
+### Trajet des paquets
+Lorsque l'on met en place un VPN sur son serveur, si on ne met pas en place de configuration particulière, le transfert d'un fichier d'un ordinateur du réseau local vers le serveur utilisant le VPN, passera par le bout du VPN c'est-à-dire par le serveur du fournisseur de VPN.
+
+Pour pallier à ce point, il y a deux solutions :
+- transformer son serveur en routeur et connecter les équipements de la maison à ce dernier, ces équipements bénéficieront alors de la confidentialité du VPN également.
+- utiliser le serveur YunoHost comme solveur DNS lorsque l'on est chez soi, de façon à rediriger les noms de domaines du serveur l'ip locale plutôt que l'ip publique. Cette opération peut se faire soit sur chaque équipements, soit sur le routeur (si ce dernier le permet).