diff --git a/admindoc.md b/admindoc.md
index cb87d8d1..eb82a480 100644
--- a/admindoc.md
+++ b/admindoc.md
@@ -5,11 +5,21 @@
* [What is Self-hosting](/selfhosting)
* [Compatible hardware](/hardware)
* [Installation guide](/install)
- * [On ARM board](/install_on_arm_board)
- * [On Raspberry Pi](/install_on_raspberry)
- * [From the ISO image](/install_iso)
- * [On Debian](/install_on_debian)
- * [On VirtualBox](/install_on_virtualbox)
+ * [On an OLinuXino board](/install_on_olinuxino)
+ * [On an ARM board](/install_on_arm_board)
+ * [On a Raspberry Pi](/install_on_raspberry)
+ * [From an ISO](/install_iso)
+ * [On Debian](/install_on_debian)
+ * [On VirtualBox](/install_on_virtualbox)
+ * [On Vagrant](/vagrant)
+ * [On a dedicated or a virtual private server](/install_on_vps)
+ * Installation steps
+ * [Burn or copy iso](/burn_or_copy_iso)
+ * [Boot and graphical install](/boot_and_graphical_install)
+ * [Copy YunoHost image on SD card](/copy_image)
+ * [Manual instalation](/install_manually)
+ * [Plug and boot your server](/plug_and_boot)
+ * [Post-instalation](/postinstall)
* [Available applications](/apps)
* [Administration interface usage](/admin)
* [Command-line interface usage](/moulinette)
diff --git a/admindoc_fr.md b/admindoc_fr.md
index 5bde3f4d..a37c1617 100644
--- a/admindoc_fr.md
+++ b/admindoc_fr.md
@@ -3,23 +3,22 @@
* [L’auto-hébergement](/selfhosting_fr)
* [Matériel compatible](/hardware_fr)
* [Guide d’installation](/install_fr)
- * [Sur carte ARM](/install_on_arm_board_fr)
- * [Sur Raspberry Pi](/install_on_raspberry_fr)
- * [À partir de l’ISO](/install_iso_fr)
- * [Sur Debian](/install_on_debian_fr)
- * [Sur VirtualBox](/install_on_virtualbox_fr)
- * [Sur Docker](/docker_fr)
- * [Sur Vagrant](/vagrant_fr)
- * [Sur un conteneur DigitalOcean](/install_on_digitalocean_fr)
- * [Sur un serveur dédié](/install_on_dedicated_server_fr)
- * Étapes d’installation
- * [Graver ou copier l’ISO](/burn_or_copy_iso_fr)
- * [Démarrage et installation graphique](/boot_and_graphical_install_fr)
- * [Copier l’image YunoHost sur une carte SD](/copy_image_fr)
- * [Installation manuelle](/install_manually_fr)
- * [Brancher et démarrer votre serveur](/plug_and_boot_fr)
- * [Post-installation](/postinstall_fr)
- * [Diagnostic du bon fonctionnement du YunoHost](/diagnostic_fr)
+ * [Sur une carte OLinuXino](/install_on_olinuxino_fr)
+ * [Sur carte ARM](/install_on_arm_board_fr)
+ * [Sur Raspberry Pi](/install_on_raspberry_fr)
+ * [À partir de l’ISO](/install_iso_fr)
+ * [Sur Debian](/install_on_debian_fr)
+ * [Sur VirtualBox](/install_on_virtualbox_fr)
+ * [Sur Vagrant](/vagrant_fr)
+ * [Sur un serveur dédié](/install_on_vps_fr)
+ * Étapes d’installation
+ * [Graver ou copier l’ISO](/burn_or_copy_iso_fr)
+ * [Démarrage et installation graphique](/boot_and_graphical_install_fr)
+ * [Copier l’image YunoHost sur une carte SD](/copy_image_fr)
+ * [Installation manuelle](/install_manually_fr)
+ * [Brancher et démarrer votre serveur](/plug_and_boot_fr)
+ * [Post-installation](/postinstall_fr)
+ * [Diagnostic du bon fonctionnement du YunoHost](/diagnostic_fr)
* [DNS - Système de nom de domaine](/dns_fr)
* [Bureaux d’enregistrements de nom de domaine - Registrar](registrar_fr)
* [Configuration du DNS chez son registrar](/dns_config_fr)
diff --git a/images/computer.png b/images/computer.png
new file mode 100644
index 00000000..575d0d43
Binary files /dev/null and b/images/computer.png differ
diff --git a/images/olinuxino.jpg b/images/olinuxino.jpg
new file mode 100644
index 00000000..2191b7c5
Binary files /dev/null and b/images/olinuxino.jpg differ
diff --git a/images/raspberrypi.jpg b/images/raspberrypi.jpg
new file mode 100644
index 00000000..3ddacd24
Binary files /dev/null and b/images/raspberrypi.jpg differ
diff --git a/install.md b/install.md
index 0e06fdd2..c07a291c 100644
--- a/install.md
+++ b/install.md
@@ -10,14 +10,22 @@ This page lists a few installation guides.
+
+
+
@@ -25,25 +33,43 @@ This page lists a few installation guides.
---
-Install @ home
+Install at home
+
+
+
+
+---
+
+Install on a remote server
+
+
+ Local associative ISP near you might be able to provide you with a *Virtual Private Server* (VPS), managed by human beings who respect users and care about [Net Neutrality](https://en.wikipedia.org/wiki/Net_neutrality) ! Check out [this page](https://db.ffdn.org/) for more information.
+
+
+
@@ -52,48 +78,19 @@ This page lists a few installation guides.
---
-On a virtual machine/container
+Advanced / others
-
-
-
----
-
-On a remote server
-
-
-
----
-
-On Debian
-
-If you have already installed **Debian 8** (Jessie) on a server, you'll be able to **[install YunoHost with a simple script](/install_on_debian)**.
-
-
diff --git a/install_fr.md b/install_fr.md
index 8c0351b5..22021835 100644
--- a/install_fr.md
+++ b/install_fr.md
@@ -1,6 +1,6 @@
# Guide d’installation
-Il existe plusieurs manières d’installer YunoHost. La méthode d’installation diffère légèrement si vous souhaitez l’installer chez vous ou à distance, et du matériel utilisé : **[voir le matériel compatible](/hardware_fr)**
+Il existe plusieurs manières d’installer YunoHost. La méthode d’installation diffère légèrement si vous souhaitez l’installer chez vous ou à distance, et du matériel utilisé : **[voir le matériel compatible](/hardware_fr)**
Cette page liste plusieurs types d’installations, classés par catégories.
@@ -10,14 +10,17 @@ Cette page liste plusieurs types d’installations, classés par catégories.
@@ -30,19 +33,19 @@ Cette page liste plusieurs types d’installations, classés par catégories.
@@ -51,48 +54,35 @@ Cette page liste plusieurs types d’installations, classés par catégories.
---
-Virtuellement
+Installer à distance
+
+
+ Des FAI associatifs près de chez vous sont peut-être capable de vous fournir un *Serveur Privé Virtuel* (VPS), géré par des humains qui respectent les utilisateurs et la [Neutralité du Net](https://fr.wikipedia.org/wiki/Neutralit%C3%A9_du_r%C3%A9seau) ! Voir [cette page](https://db.ffdn.org/) pour plus d'informations.
+
+
+
+
+
+
+---
+
+Advanced / others
-
-
-
----
-
-À distance
-
-
-
-
-
----
-
-Sur Debian
-
-Si vous disposez déjà d’un serveur ou d’un ordinateur sous **Debian 8** (Jessie), suivez l’**[installation par script](/install_on_debian_fr)**.
-
-
diff --git a/install_on_digitalocean.md b/install_on_digitalocean.md
deleted file mode 100644
index 324bb8e6..00000000
--- a/install_on_digitalocean.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# Install on a DigitalOcean droplet
-
-*Find other ways to install YunoHost **[here](/install)**.*
-
-### Pre-requisite
-
-
-
-* A [DigitalOcean](https://www.digitalocean.com/) account
-* A **Debian 7.x or 8.x 64bits** droplet with at least **512MB** RAM
-
-
- Note : The `root` user **must** have a password properly set. Run `sudo passwd root` to ensure this.
-
-
-
----
-
-## Installation steps
-
-1. Install manually
-
-2. Post-install
-
----
-
-***If you need help during one of these steps, do not hesitate to use [our support tools](/support).***
\ No newline at end of file
diff --git a/install_on_digitalocean_fr.md b/install_on_digitalocean_fr.md
deleted file mode 100644
index 3ca82b97..00000000
--- a/install_on_digitalocean_fr.md
+++ /dev/null
@@ -1,26 +0,0 @@
-# Installation sur un conteneur DigitalOcean
-
-*Trouvez d’autres moyens d’installer YunoHost **[ici](/install_fr)**.*
-
-## Prérequis
-
-
-
-* Un compte [DigitalOcean](https://www.digitalocean.com/)
-* Un conteneur **Debian 7.x ou 8.x 64 bits** avec au moins **512MB** de RAM
-
-
- Attention : l’utilisateur `root` doit posséder un mot de passe. Exécutez `sudo passwd root` pour être sûr qu’il est configuré correctement.
-
-
----
-
-## Étapes d’installation
-
-1. Installer manuellement
-
-2. Post-installation
-
----
-
-***Si vous avez besoin d’aide lors de ces étapes, n’hésitez pas à utiliser les différents [moyens de support](/support_fr).***
diff --git a/install_on_raspberry.md b/install_on_raspberry.md
index 3def8d0a..e2c663e4 100644
--- a/install_on_raspberry.md
+++ b/install_on_raspberry.md
@@ -1,21 +1,22 @@
# Install YunoHost on a Raspberry Pi
-*Find other ways to install YunoHost **[here](/install)**.*
+*Find all the ways to install YunoHost **[here](/install)**.*
+
+
+
+
+
+
+Before setting up a server at home, it is recommended that you know the [limitations imposed by your ISP](/isp). If they are too restrictive you can consider using a VPN to get around those limitations.
+
## Pre-requisite
-
-
-- A Raspberry Pi model 1, 2 or 3
-- An SD card: **4GB** capacity (or more) and **class10** speed rate is highly recommended
-- An other computer to read this guide and access to your Raspberry Pi
-- A screen and a keyboard are recommended to control your Raspberry Pi if a problem occurs.
-- A [reasonable ISP](/isp), preferably with a good and unlimited upstream bandwidth
-- **YunoHost Raspberry Pi images**, available here:
-
-build.yunohost.org
-
-There are two ways of installing, depending on if you can start your server from scratch or not.
+- An SD card: **8GB** capacity (at least) and **Class 10** speed rate are highly recommended (like the [Transcend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO)) ;
+- A power supply (either an adapter or a MicroUSB cable)
+- An ethernet cable (RJ-45) to connect your Raspberry Pi to your router. (Raspberry Pi Zero users can connect the Pi using an OTG cable, Wifi dongle and [following these instructions](https://davidmaitland.me/2015/12/raspberry-pi-zero-headless-setup/))
+- The **YunoHost Raspberry Pi image**, available on [build.yunohost.org](http://build.yunohost.org/). (Not needed if you want to manually install YunoHost on an existing Debian system.)
+- **(Optional)** A screen and a keyboard, if you can't use an ssh connection to proceed to the post-installation. (Not needed when installing with an image.)
---
@@ -25,13 +26,23 @@ There are two ways of installing, depending on if you can start your server from
2. Plug & boot
-3. Post-install
+3. Connect to your server with SSH
+
+4. Proceed to post-installation
+
+---
## Manual installation
-Follow these steps if you can't start from scratch and simply use an image. Note - Yunohost installation is different if you have a Raspberry Pi Zero, be careful!
-1. Install git
+0. Install Raspbian on the SD card and connect to your Pi.
+
+1. The root user must have a password, or the installation will fail. To change the root password:
+```bash
+sudo passwd root
+```
+
+2. Install git
```bash
sudo apt-get install git
```
@@ -41,52 +52,11 @@ sudo apt-get install git
git clone https://github.com/YunoHost/install_script /tmp/install_script
```
-3. The root user must have a password set, if it isn't the case, set it (whithout the install script failed):
-```bash
-sudo passwd root
-```
-
-4. Update the Pi:
-```bash
-apt-get update ; apt-get dist-upgrade -y ; apt-get install rpi-update ; rpi-update ; reboot`
-```
-
-This will upgrade the Pi, then reboot.
-
-
-Raspberry Pi Zero users: follow these specific steps for a successfull installation.
-
-
-
-0.1 Install metronome manually:
-```bash
-apt-get install -y ssl-cert lua-event lua-expat lua-socket lua-sec lua-filesystem
-wget https://github.com/YunoHost/metronome/archive/debian/3.7.9+33b7572-1.zip
-unzip 3.7.9+33b7572-1.zip
-cd metronome-debian-3.7.9-33b7572-1
-dpkg-buildpackage -rfakeroot -uc -b -d
-cd ..
-dpkg -i metronome_3.7.9+33b7572-1_armhf.deb
-apt-mark hold metronome
-```
-
4. Execute the installation script
```bash
cd /tmp/install_script && sudo ./install_yunohost
```
----
-
-### Recommended after post-installation
-
-* Connect via SSH: **root@IP.OF.RPI** (password: **yunohost**)
-* Change root password: `passwd root`
-* Upgrade system: `apt-get update && apt-get dist-upgrade && rpi-update`
-* Configure the language, keyboard layout and timezone with the **raspi-config** tool
---
-#### Build image
-* [Create a Raspberry Pi image](/build_arm_image_en)
-
***If you need help during one of these steps, do not hesitate to use [our support tools](/support).***
-
diff --git a/install_on_raspberry_fr.md b/install_on_raspberry_fr.md
index 48f7656a..71401f26 100644
--- a/install_on_raspberry_fr.md
+++ b/install_on_raspberry_fr.md
@@ -2,21 +2,22 @@
*Toutes les autres façons d’installer YunoHost sont listées **[ici](/install_fr)**.*
+
+
+
+
+
+Avant d'héberger un serveur chez vous, il est recommandé de prendre connaissance des [limitations liées à votre FAI](/isp). Si votre FAI est trop contraignant, il est possible d'utiliser un VPN pour contourner ces limitations.
+
+
## Prérequis
-
-
-- Un Raspberry Pi 1, 2 ou 3
-- Une carte SD de capacité minimale de **4 Go** et une certification de vitesse **class10** sont recommandées
-- Un autre ordinateur pour parcourir ce guide et accéder à votre Raspberry Pi
-- Un écran et un clavier sont recommandés pour pouvoir contrôler votre Raspberry Pi si un problème apparaît
-- Un [fournisseur d’accès correct](/isp_fr), de préférence avec une bonne vitesse d’upload
-- Les **images YunoHost pour Raspberry Pi**, disponible ici :
- - [Officielle, Wheezy/YunoHost 2.2 créée le 4 juin 2015](http://build.yunohost.org/yunohost4rpi2.img.7z)
- - [Non officielle Jessie/YunoHost 2.2 créée le 5 décembre 2015](https://forum.yunohost.org/t/building-a-new-image-for-raspberry-debian-jessie-fr-en/1101/2)
-- Un tutoriel d'installation basée sur YunoHost 2.4 a été écrit par AviGNU : http://avignu.wiki.tuxfamily.org/doku.php?id=documentation:yunohost-jessie
-
-Il y a deux façon d'installer Yunohost, soit vous pouvez repartir de zéro avec une nouvelle image ou installer manuellement :
+- Un Raspberry Pi 0, 1, 2 ou 3 ;
+- Une carte SD : au moins **8 Go** et **Classe 10** (par exemple une [Transcend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO)) ;
+- Un adaptateur secteur pour la alimenter la carte ;
+- Un câble ethernet/RJ-45 pour brancher la carte à votre routeur/box internet. Avec le Raspberry Pi Zero vous pouvez connecter votre carte avec un câble OTG et un adaptateur Wifi USB.
+- L'image YunoHost pour Raspberry Pi, à télécharger sur [build.yunohost.org](http://build.yunohost.org/). (Pas nécessaire si vous souhaitez faire une installation manuelle sur un système Debian déjà installé)
+- **(Optionnel)** Un écran et un clavier s'il n'est pas possible de se connecter directement en SSH au Raspberry. (Pas nécessaire si vous installez depuis l'image)
---
@@ -26,70 +27,39 @@ Il y a deux façon d'installer Yunohost, soit vous pouvez repartir de zéro avec
2. Brancher & démarrer
-3. Post-installation
+3. Se connecter en SSH
+4. Procéder à la post-installation
+
+---
## Installation manuelle
-Utilisez cette méthode si vous ne pouvez pas repartir de zéro et utiliser une image. Attention, ces étapes sont différentes si vous installez sur un Raspberry Pi Zero !
-1. Installer git
-```bash
-sudo apt-get install git
-```
+0. Installez Raspbian sur la carte SD puis connectez-vous en ssh au Raspberry Pi.
+
-2. Cloner le repo Yunohost install script
-```bash
-git clone https://github.com/YunoHost/install_script /tmp/install_script
-```
-3. L'user root doit avoir un mot de passe. Si ce n'est pas le cas l'installation ne marchera pas:
+1. L'user root doit avoir un mot de passe. (Si ce n'est pas le cas l'installation ne marchera pas.)
```bash
sudo passwd root
```
-4. Mettre à jour le Pi:
+2. Installer git
```bash
-apt-get update ; apt-get dist-upgrade -y ; apt-get install rpi-update ; rpi-update ; reboot`
+sudo apt-get install git
```
-Cela va mettre à jour le Pi, puis rebooter.
-
-
-Raspberry Pi Zero : suivez ces étapes pour une installation réussie.
-
-
-
-0.1 Installez metronome manuellement:
+3. Récupérer le script d'installation de Yunohost
```bash
-apt-get install -y ssl-cert lua-event lua-expat lua-socket lua-sec lua-filesystem
-wget https://github.com/YunoHost/metronome/archive/debian/3.7.9+33b7572-1.zip
-unzip 3.7.9+33b7572-1.zip
-cd metronome-debian-3.7.9-33b7572-1
-dpkg-buildpackage -rfakeroot -uc -b -d
-cd ..
-dpkg -i metronome_3.7.9+33b7572-1_armhf.deb
-apt-mark hold metronome
+git clone https://github.com/YunoHost/install_script /tmp/install_script
```
-4. Executer le script d' installation
+4. Executez le script d' installation
```bash
cd /tmp/install_script && sudo ./install_yunohost
```
---
-### Recommandé après la post-installation
-
-* Se connecter en [ssh](ssh_fr) : **root@IP.DU.RPI** (mot de passe : **yunohost**)
-* Changer le mot de passe root : ```passwd root```
-* Mettre à jour le système d’exploitation : ```apt-get update && apt-get dist-upgrade && rpi-update```
-* Configurer la langue, le clavier et le fuseau horaire avec l'outil **raspi-config**
-
----
-
-#### Créer une image
-* [Créer une image pour Raspberry](/build_arm_image_fr)
-
----
-***Si vous avez besoin d’aide lors de ces étapes, n’hésitez pas à utiliser les différents [moyens de support](/support_fr).***
+***Si vous avez besoin d’aide lors de ces étapes, n’hésitez pas à utiliser les différents [outils de support](/support_fr).***
diff --git a/install_on_dedicated_server.md b/install_on_vps.md
similarity index 71%
rename from install_on_dedicated_server.md
rename to install_on_vps.md
index f154d04c..d16c436e 100644
--- a/install_on_dedicated_server.md
+++ b/install_on_vps.md
@@ -6,8 +6,9 @@
-* A dedicated server **OR** a VPS with at least **256MB** RAM
-* A **Debian 8** or **7** OS up and running on it
+* A dedicated or virtual private server
+* with at least **512MB** RAM
+* and **Debian 8.x (Jessie) 64bits** as operating system
---
@@ -19,4 +20,4 @@
---
-***If you need help during one of these steps, do not hesitate to use [our support tools](/support).***
\ No newline at end of file
+***If you need help during one of these steps, do not hesitate to use [our support tools](/support).***
diff --git a/install_on_dedicated_server_fr.md b/install_on_vps_fr.md
similarity index 80%
rename from install_on_dedicated_server_fr.md
rename to install_on_vps_fr.md
index 899edf6e..c8ef3df7 100644
--- a/install_on_dedicated_server_fr.md
+++ b/install_on_vps_fr.md
@@ -6,8 +6,9 @@
-* Un serveur dédié **OU** un VPS avec au moins **256 MB** de RAM
-* Une installation **Debian 8** ou **7** fonctionnelle
+* Un serveur dédié ou virtuel
+* avec au moins **512MB** RAM
+* et **Debian 8.x (Jessie) 64bits** come système d'exploitation
---
diff --git a/sitemap.md b/sitemap.md
index 2cb99f02..1f82bcd6 100644
--- a/sitemap.md
+++ b/sitemap.md
@@ -14,18 +14,16 @@
* [Self-hosting](/selfhosting_en)
* [Hardware compatible](/hardware)
* [Installation guide](/install)
- * [On the Internet Cube](/install_brick_en)
+ * [On an OLinuXino board](/install_on_olinuxino)
* [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)
* [On VirtualBox](/install_on_virtualbox)
- * [On Docker](/docker)
* [On Vagrant](/vagrant)
- * [On a DigitalOcean droplet](/install_on_digitalocean)
- * [On a dedicated or a virtual private server](/install_on_dedicated_server)
- * Instalation steps
+ * [On a dedicated or a virtual private server](/install_on_vps)
+ * Installation steps
* [Burn or copy iso](/burn_or_copy_iso)
* [Boot and graphical install](/boot_and_graphical_install)
* [Copy YunoHost image on SD card](/copy_image)
diff --git a/sitemap_fr.md b/sitemap_fr.md
index 5d2a5cae..90e29d8c 100644
--- a/sitemap_fr.md
+++ b/sitemap_fr.md
@@ -14,17 +14,15 @@
* [L’auto-hébergement](/selfhosting_fr)
* [Matériel compatible](/hardware_fr)
* [Guide d’installation](/install_fr)
- * [Sur la Brique Internet](/installation_brique_fr)
+ * [Sur une carte OLinuXino](/install_on_olinuxino_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)
* [Sur VirtualBox](/install_on_virtualbox_fr)
- * [Sur Docker](/docker_fr)
* [Sur Vagrant](/vagrant_fr)
- * [Sur un conteneur DigitalOcean](/install_on_digitalocean_fr)
- * [Sur un serveur dédié](/install_on_dedicated_server_fr)
+ * [Sur un serveur dédié](/install_on_vps_fr)
* Étapes d’installation
* [Graver ou copier l’ISO](/burn_or_copy_iso_fr)
* [Démarrage et installation graphique](/boot_and_graphical_install_fr)
diff --git a/ssh.md b/ssh.md
index 1fa9488b..d0561a2a 100644
--- a/ssh.md
+++ b/ssh.md
@@ -1,26 +1,65 @@
-#SSH
-**SSH** permit you to command remotly your sever by command line interface (CLI).
+# SSH
-##### To connect to your server:
+## What's SSH ?
-`ssh admin@my-server.org`
+**SSH** stands for Secure Shell, and refers to a protocol that allows to remotly control a machine using the command line interface (CLI). It is available by default on Linux and Mac OS / OSX. On Windows, unfortunately you might need to use the [PuTTy](http://www.fastcomet.com/tutorials/getting-started/putty) software.
+
+## During Yunohost installation
+
+#### Find your IP
+
+If you are installing on a VPS, then your VPS provider should have gave you your IP address.
+
+If you are installing at home (e.g. on a Raspberry Pi or OLinuXino), then you need to find out which IP has been attributed to your board after you plugged it to your internet box / router. Several ways exists to find your server's IP :
+
+- open a terminal and use `sudo arp-scan --local` to list the IP on your local network ;
+- use your internet box / router interface to list the machines connected, or check the logs ;
+- plug a screen on your server, log in and type `ifconfig`.
+
+#### Connect
+
+Assuming your IP address is `111.222.333.444`, open a terminal and enter :
+
+```bash
+ssh root@111.222.333.444
+```
+
+A password will be asked. If this is a VPS, your VPS provided should have communicated you the password. On a fresh Raspberry Pi, the password might be `raspberry`. For an OLinuXino, this should be `olinux`.
+
+#### Change the password !
+
+After logging in for the first time, you should change the root password. The server might automatically ask you to do so. If not, use the command `passwd`. It is important to choose a reasonably strong password.
+
+## After installing Yunohost
+
+If you installed your server at home and are attempting to connect from outside your local network, make sure port 22 is correctly forwarded to your server.
+
+If you only know the IP of your server :
+
+```bash
+ssh admin@111.222.333.444
+```
Then, you need to enter your administrator password created at [post-installation step](postinstall).
-##### Connect to a different port than the default port 22
-Edit the line`Port 22` from file `/etc/ssh/sshd_config` then connect:
+If you configured your DNS (or tweaked your `/etc/hosts`), you can simply use your domain name :
+
```bash
-ssh -p admin@my-server.org
+ssh admin@your.domain.tld
```
-##### Which users?
-Only the admin user can log in to YunoHost ssh server.
+If you changed the SSH port, you need to add `-p ` to the command, e.g. :
-YunoHost's users created via the administration interface are managed by the LDAP directory and can not connect via ssh.
+```bash
+ssh -p 2244 admin@your.domain.tld
+```
-If you want another admin user to log in via ssh, you must create it from the command line (through the admin user) as any user (with `adduser` command).
+## Which users?
-Note: this user will not be usable since yunohost. It will have its own folder `/home`, his own Unix group (see the principles of a Unix user and the various tutorials on the subject in any good documentation on the administration in Debian).
+By default, only the admin and root users can log in to YunoHost ssh server.
-##### Security and SSH
-See the dedicated page [Security & SSH](security_en)
\ No newline at end of file
+YunoHost's users created via the administration interface are managed by the LDAP directory. By default, they can't connect via SSH for security reasons. See [here](https://forum.yunohost.org/t/ssh-disconnects-after-successful-login/256/10) if you absolutely want some users to have SSH access enabled.
+
+## Security and SSH
+
+See the dedicated page [Security & SSH](security_en)
diff --git a/ssh_fr.md b/ssh_fr.md
index 2e6f661a..b9eec976 100644
--- a/ssh_fr.md
+++ b/ssh_fr.md
@@ -1,26 +1,65 @@
# SSH
-Le **SSH** permet de commander à distance son serveur en ligne de commande (CLI).
-#### Pour se connecter à son serveur
-```bash
-ssh admin@mon-serveur.org
-```
-Ensuite, il est demandé le mot de passe administrateur, celui créé à [l’étape de post-installation](postinstall_fr).
+## Qu'est-ce que SSH ?
+
+**SSH** est un accronyme pour Secure Shell, et désigne un protocole qui permet de contrôler à distance une machine via la ligne de commande (CLI). C'est aussi une commande disponible de base sur Linux et Mac OS / OSX. Sous Windows, maleureusement il vous faudra utiliser le logiciel [PuTTy](http://www.fastcomet.com/tutorials/getting-started/putty).
+
+## Pendant l'installation de YunoHost
+
+#### Trouver son IP
+
+Si vous installez YunoHost sur un VPS, votre fournisseur devrait vous avoir communiqué l'adresse IP de votre serveur.
+
+Si vous installez un serveur à la maison (par ex. sur Raspberry Pi ou OLinuXino), il vous faut trouver l'IP qui a été attribuée à votre carte après que vous l'ayez connecté à votre box internet / routeur. Il y a plusieurs façon de faire ça :
+
+- ouvrez un terminal et tapez `sudo arp-scan --local` pour lister les IP des machines sur le réseau local ;
+- utilisez l'interface de votre box internet pour lister les machines connectées, ou regarder les logs ;
+- branchez un écran sur votre serveur, loggez-vous et tapez `ifconfig`.
+
+#### Se connecter
+
+En supposant que votre adresse IP est `111.222.333.444`, ouvrez un terminal et tapez :
-#### Se connecter à un port différent du port par défaut 22
-Éditer la ligne `Port 22` du fichier `/etc/ssh/sshd_config`, puis connectez-vous :
```bash
-ssh -p admin@mon-serveur.org
+ssh root@111.222.333.444
```
-#### Quels utilisateurs ?
-Seul l’utilisateur `admin` peut se connecter en ssh aux serveurs YunoHost.
+Un mot de passe sera demandé. Si c'est un VPS, votre fournisseur devrait également vous avoir communiqué un mot de passe. Sur un Raspberry Pi, le password devrait être `raspberry`. Sur un OLinuXino, cela devrait être `olinux`.
-Les utilisateurs YunoHost, qui sont gérés par l’annuaire LDAP, ne peuvent pas se connecter en ssh.
+#### Changer le mot de passe root !
-Si vous souhaitez avoir d’autres utilisateurs que l’admin pour vous connectez en ssh, il faut le créer depuis la ligne de commande (via l’utilisateur admin) comme n’importe quel utilisateur (avec la commande `adduser`).
+Après vous être loggé pour la première fois, il vous faut changer le mot de passe root. Le serveur vous demandera peut-être automatiquement de le faire. Si ce n'est pas le cas, il faut utiliser la commande `passwd`. Il est important de choisir un mot de passe raisonnablement compliqué.
-Remarque : cet utilisateur ne sera pas utilisable depuis YunoHost. Il aura son propre répertoire `/home`, son propre groupe (cf. les principes d’un utilisateur Unix classique et les différents tutoriaux sur le sujet dans toute bonne documentation sur l’administration sous Debian).
+## Sur une instance déjà installée
-##### Sécurité et SSH
-Voir la page dédiée [Sécurité et SSH](security_fr)
\ No newline at end of file
+Si vous avez installé votre serveur à la maison et que vous cherchez à vous connecter depuis l'extérieur du réseau local, assurez-vous d'avoir bien redirigé le port 22 vers votre serveur.
+
+Si vous connaissez seulement l'IP de votre serveur :
+
+```bash
+ssh admin@111.222.333.444
+```
+
+Ensuite, entrez le mot de passe administrateur défini pendant la [post-installation](postinstall).
+
+Si vous avez configuré vos DNS (or tweaked your `/etc/hosts`), you can simply use your domain name :
+
+```bash
+ssh admin@votre.domaine.tld
+```
+
+Si vous avez changé le port SSH, il faut rajouter `-p ` à la commande, par ex. :
+
+```bash
+ssh -p 2244 admin@votre.domaine.tld
+```
+
+## Quels utilisateurs ?
+
+Par défaut, seulement les utilisateurs admin et root peuvent se logger en SSH sur une instance Yunohost.
+
+Les utilisateurs YunoHost créé via l'interface d'administration sont géré par la base de donnée LDAP. Par défaut, ils ne peuvent pas se connecter en SSH pour des raisons de sécurité. Si vous avez absolument besoin qu'un utilisateur dispose d'un accès SSH, vous pouvez utiliser [cette manipulation](https://forum.yunohost.org/t/ssh-disconnects-after-successful-login/256/10).
+
+## SSH et sécurité
+
+Voir la page dédiée à la [sécurité](security_fr)
diff --git a/troubleshooting_guide.md b/troubleshooting_guide.md
index 20d1b409..c6ada8fc 100644
--- a/troubleshooting_guide.md
+++ b/troubleshooting_guide.md
@@ -5,7 +5,7 @@ You can consider this as some kind of administrator guide for troubleshooting or
## General notes
### Do not break YunoHost
Best way to troubleshoot is to not have to troubleshoot because you have tested everything before deploying it on your server.
-That means everytime you want to try a new thing (non-official app, new specific config, package an app…) try it on a development or testing server not on your production one. For this, use whatever way you think appropriate, you can use YunoHost on a [DigitalOcean droplet](install_on_digitalocean_en) for 1 cent/hour, locally with [Docker](/docker_en) or a VM for example.
+This means that everytime you want to try a new thing (non-official app, new specific config, package an app...), you should try it on a development or testing instance, *not* on your production server. For this, you can [set up a Vagrant box](vagrant), or for instance a [DigitalOcean droplet](install_on_vps) for 1 cent/hour.
Also: https://wiki.debian.org/DontBreakDebian
@@ -342,4 +342,4 @@ Webapp can take multiple form an can be deployed in many way. Go app have usuall
Never install Apache or a package withe Apache as dependency, this will probably break your YunoHost intance.
##### Note on https
-Sometimes the webserver integrated with the app is capable to serve https on its own, it's right to use this when you have one application on one server and you don't want to install Nginx for intance. But in YunoHost case, Nginx who serve https and it simplify configuration. So when passing the local URL to Nginx via proxy_pass, use http, nginx will https the thing to the open world later.
\ No newline at end of file
+Sometimes the webserver integrated with the app is capable to serve https on its own, it's right to use this when you have one application on one server and you don't want to install Nginx for intance. But in YunoHost case, Nginx who serve https and it simplify configuration. So when passing the local URL to Nginx via proxy_pass, use http, nginx will https the thing to the open world later.
diff --git a/troubleshooting_guide_fr.md b/troubleshooting_guide_fr.md
index 9fb5abb1..5298c265 100644
--- a/troubleshooting_guide_fr.md
+++ b/troubleshooting_guide_fr.md
@@ -5,8 +5,7 @@ Ce guide peut trouver son intérêt lors du débuggage d’une nouvelle applicat
## Notes générales
### Ne cassez pas YunoHost
-La meilleure manière de ne pas avoir de pannes est de ne pas bricoler sur votre serveur. Cela signifie que dès que vous souhaitez essayer quelque chose de nouveau (application non officielle, nouvelle configuration personnalisée, création d’une nouvelle application), voyez plutôt cela sur un serveur de développement et non de production.
-Vous pouvez faire cela de la manière qui vous convient, sur un [Droplet DigitalOcean](install_on_digitalocean_en) pour 1 centime/heure, localement avec [Docker](/docker_en) ou sur une machine virtuelle.
+La meilleure manière de ne pas avoir de pannes est de ne pas bricoler sur votre serveur. Cela signifie que dès que vous souhaitez essayer quelque chose de nouveau (application non officielle, nouvelle configuration personnalisée, création d’une nouvelle application), essayez d'abord cela sur un serveur de test et non de production. Pour faire cela, vous pouvez par exemple utiliser une [box Vagrant](vagrant_fr) ou un [droplet DigitalOcean](install_on_vps_fr) pour 1 centime/here.
Vous pouvez aussi lire ceci si vous avez encore envie de bricoler sur votre instance YunoHost en production : https://wiki.debian.org/DontBreakDebian
@@ -16,7 +15,7 @@ Avant de tester, vous devriez lire au moins le code source de l’application et
Garder à l’esprit que quand vous installez une application, vous exécutez du code avec des droits root. De mon expérience, certaines applications sont excellentes, d’autres peuvent casser votre instance YunoHost et certaines ne sont plus maintenues. Alors, avant d’installer, regardez les problèmes rencontrés (issues dans GitHub), le [Forum](http://forum.yunohost.org/)
et [le salon de discussion Yunohost](support_fr) pour voir si d’autres ont eu des problèmes avec l’application.
-### vérifier la documentation officielle
+### Vérifier la documentation officielle
Les réponses à vos questions existent peut être déjà dans [la documentation](sitemap_fr).
### Vérifier l’aide dans les commandes en ligne
@@ -367,4 +366,4 @@ Ne jamais installer le serveur web Apache ou un paquet avec Apache comme dépend
##### Note sur https
Parfois, le serveur web intégré avec l’application est capable de servir du https lui-même.
-C’est une bonne chose de l’utiliser quand vous disposez d’une application sans Nginx devant. Dans le cadre de YunoHost, le fait que Nginx serve du https simplifie la configuration. Donc, quand vous passez par proxy_pass, utilisez http et Nginx mettra a disposition en https pour le reste de l’internet.
\ No newline at end of file
+C’est une bonne chose de l’utiliser quand vous disposez d’une application sans Nginx devant. Dans le cadre de YunoHost, le fait que Nginx serve du https simplifie la configuration. Donc, quand vous passez par proxy_pass, utilisez http et Nginx mettra a disposition en https pour le reste de l’internet.
