Misc fixes / improvements / drop outdated stuff..

admin.md

@@ -10,28 +10,3 @@ You can access your administrator web interface at this address: https://example
 <img src="/images/webadmin.png" style="max-width:100%;">
 </div>
 
-
-### Reset admin password
-
-To reset the admin password (as root) :
-
-```bash
-$ yunohost-reset-ldap-password
-```
-
-A temporary password will be created, which you can use to define the new password.
-
-
-### How to move application folder
-
-To change an application folder, only a few commands are needed: move content, create a symlink and set access rights.
-
-Sample with WordPress:
-```bash
-# Move wordpress folder to an external hard drive
-$ sudo  mv /var/www/wordpress /media/externalharddrive 
-# Symbolic link
-$ sudo   ln -s /media/externalharddrive/wordpress /var/www/wordpress
-# Folder must belong to www-data
-$ sudo  chown -R www-data:www-data /media/externalharddrive/wordpress
-```

admin_es.md

@@ -9,29 +9,3 @@ La interfaz admin está accesible desde tu instancia Yunohost en esta dirección
 <div class="text-center" style="max-width:100%;border-radius: 5px;border: 1px solid rgba(0,0,0,0.15);box-shadow: 0 5px 15px rgba(0,0,0,0.35);">
 <img src="/images/webadmin.png" style="max-width:100%;">
 </div>
-
-
-### Reinicia la contraseña del administrador
-
-Para reiniciar la contraseña de administración de Yunohost (con el usuario root) :
-
-```bash
-$ yunohost-reset-ldap-password
-```
-
-Una contraseña provisional será creada, podrás utilizarla para luego definir una nueva contraseña.
-
-
-### Cómo mover la carpeta de una aplicación 
-
-Para cambiar la carpeta donde está una aplicación, sólo algunos comandos son necesarios : desplazar el contenido, crear un vínculo simbólico y definir los derechos de acceso.
-
-Ejemplo con WordPress :
-```bash
-# Desplazamiento del wordpress hacia otro soporte
-$ sudo  mv /var/www/wordpress /mon/dossier/cible
-# Creación del vínculo simbólico 
-$ sudo ln -s /media/disqueexterne/wordpress /var/www/wordpress
-# El directorio debe pertenecer a www-data
-sudo chown -R www-data:www-data /media/externalharddrive/wordpress
-```

admin_fr.md

@@ -10,28 +10,3 @@ L’interface admin est accessible depuis votre instance YunoHost à l’adresse
 <img src="/images/webadmin_fr.png" style="max-width:100%;">
 </div>
 
-
-### Réinitialiser le mot de passe administrateur
-
-Pour réinitialiser le mot de passe administrateur de YunoHost (à partir de l'utilisateur root) :
-
-```bash
-$ yunohost-reset-ldap-password
-```
-
-Un mot de passe temporaire sera créé, que vous pouvez utiliser pour ensuite définir un nouveau mot de passe.
-
-
-### Comment déplacer le dossier d’une application
-
-Pour changer le dossier contenant une application, seules quelques commandes sont nécessaires : déplacer le contenu, créer un lien symbolique et définir les droits d’accès.
-
-Exemple avec WordPress :
-```bash
-# Deplacement du wordpress vers un autre support
-$ sudo  mv /var/www/wordpress /mon/dossier/cible
-# Création du lien symbolique
-$ sudo ln -s /media/disqueexterne/wordpress /var/www/wordpress
-# Le répertoire doit appartenir à www-data
-sudo chown -R www-data:www-data /media/externalharddrive/wordpress
-```

admindoc.md

@@ -38,9 +38,11 @@
 * Going further
     * [Specific apps documentations](/appsdoc)
     * [Noho.st / nohost.me / ynh.fr domain names](/dns_nohost_me)
+    * [DNS and subdomains for apps](/dns_subdomains)
     * [Exchange files with your server using a graphical interface](/filezilla)
     * [Customize the appearance of the YunoHost portal](/theming)
     * [Adding an external storage](/external_storage)
+    * [Moving an app folder to an other storage](/moving_app_folder)
     * [Migrating emails to YunoHost](/email_migration)
     * [Hide services with Tor](/torhiddenservice)
     * [A discussion about the advantages of using a VPN](/vpn_advantage)

admindoc_fr.md

@@ -51,6 +51,7 @@
     * [Échanger des fichiers avec son serveur à l'aide d'une interface graphique](/filezilla)
     * [Modifier l'apparence du portail utilisateur](/theming)
     * [Ajouter un stockage externe](/external_storage)
+    * [Déplacer un dossier d'app vers un autre stockage](/moving_app_folder)
     * [Migrer ses emails vers YunoHost](/email_migration)
     * [YunoHost avec un service caché Tor](/torhiddenservice)
     * [Utilisation de certificats autres que Let's Encrypt](/certificate_custom)

burn_or_copy_iso.md

@@ -1,15 +1,13 @@
-# Flashing the YunoHost ISO on a USB stick or CD/DVD
+# Flashing the YunoHost ISO
 
-Now that you downloaded the ISO image of YunoHost, you should flash/burn it on a physical medium. Typically, this is done on a **USB stick** but you might want to use a **CD/DVD** for older machines.
+Now that you downloaded the ISO image of YunoHost, you should flash/burn it on a physical medium. Typically, this is done on a **USB stick** or an **SD card**.
 
+<img src="/images/sdcard.jpg" width=100>
+<img src="/images/micro-sd-card.jpg" width=100>
 <img src="/images/usb_key.png" width=150>
-<img src="/images/cd.jpg" width=150>
+<img src="/images/cd.jpg" width=100>
 
----
+### (Recommended) With Etcher
-
-## USB stick
-
-### With Etcher
 
 Download <a href="https://etcher.io/" target="_blank">Etcher</a> for your operating system and install it.
 
@@ -25,20 +23,23 @@ Download <a href="https://unetbootin.github.io/">UNetbootin</a> for your operati
 
 Put your USB stick on, select your YunoHost ISO and click "OK"
 
+
 ### With `dd`
 
-If you know your way around command line, you may also flash your USB stick with
+If you are on Linux / Mac and know your way around command line, you may also
-`dd`. Assuming your USB stick is `/dev/sdz` (be careful !!), you may run :
+flash your USK stick or SD card with `dd`. You can identify which device corresponds to your
+USB stick or SD card with `fdisk -l` or `lsblk`. An SD card name typically is something like `/dev/mmcblk0`. BE CAREFUL and make sure you got the right name.
+
+Then run :
 
 ```bash
-dd if=/path/to/yunohost.iso of=/dev/sdz
+# Replace /dev/mmcblk0 if the name of your device is different...
+dd if=/path/to/yunohost.img of=/dev/mmcblk0
 ```
 
----
+### Burning a CD/DVD
 
-## CD/DVD
+For older devices, you might want to burn a CD/DVD. The software to use depends on your operating system.
-
-The software to use differs regarding your operating system.
 
 * On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc
 

burn_or_copy_iso_fr.md

@@ -1,15 +1,15 @@
-# Flasher l'ISO YunoHost sur une clef USB ou un CD/DVD
+# Flasher l'ISO YunoHost
 
-Maintenant que vous avez téléchargé l’image ISO de YunoHost, vous devez la mettre sur un support physique. Classiquement, il s'agit d'une **Clé USB** mais pour certaines raisons vous pouvez aussi utiliser un **CD/DVD**.
+Maintenant que vous avez téléchargé l’image ISO de YunoHost, vous devez la mettre sur un support physique. Classiquement, il s'agit d'une **Clé USB** ou d'une **Carte SD**.
 
+<img src="/images/sdcard.jpg" width=100>
+<img src="/images/micro-sd-card.jpg" width=100>
 <img src="/images/usb_key.png" width=150>
-<img src="/images/cd.jpg" width=150>
+<img src="/images/cd.jpg" width=100>
 
 ---
 
-## Clé USB
+### (Recommandé) Avec Etcher
-
-### Avec Etcher
 
 Téléchargez <a href="https://etcher.io/" target="_blank">Etcher</a> pour votre système d'exploitation et installez-le.
 
@@ -28,18 +28,18 @@ Branchez votre clef USB, selectionnez l'ISO YunoHost puis cliquez sur 'OK'
 ### Avec `dd`
 
 Si vous êtes familier avec la ligne de commande, il est possible de flasher la
-clef USB avec `dd`. En supposant que votre clef USB soit `/dev/sdz` (faites
+clef USB ou carte SD avec `dd`.  Vous pouvez identifier le nom du périphérique
-attention !!), vous pouvez exécuter :
+avec `fdisk -l` ou `lsblk`. Une carte SD s'apelle typiquement `/dev/mmcblk0`.
+ATTENTION à faire attention de prendre le bon nom!
 
 ```bash
-dd if=/chemin/de/yunohost.iso of=/dev/sdz
+# Remplacer /dev/mmcblk0 par le nom de votre périphérique
+dd if=/chemin/de/yunohost.iso of=/dev/mmcblk0
 ```
 
----
+### CD/DVD
 
-## CD/DVD
+Pour les anciens matériels, il vous faut peut-être utiliser un CD/DVD. Le logiciel à utiliser est différent suivant votre système d’exploitation.
-
-Le logiciel à utiliser est différent suivant votre système d’exploitation.
 
 * Sur Windows, utilisez [ImgBurn](http://www.imgburn.com/) pour écrire l’image sur le disque
 

change_admin_password.md

@@ -1,20 +1,20 @@
-#Change administration password 
+# Changing the administration password
 
-For security reasons you may have to change your administration password. To achieve this, 2 different methods exists.
+You may want to change your administrator password for security reason or because you forgot it.
 
-<div class="alert alert-warning">
+If you forgot your password or are unable to connect using the `admin` user, you
-<span class="glyphicon glyphicon-warning-sign"></span>
+may still be able to change the password if you're able to login as `root` on
-The current administration password is **required** to perform this task.
+SSH (from your local network! or using a rescue mode if you're on a VPS...)
-</div>
 
-##Web administration
+## Using the web administration interface
 
 First, connect to your [web administration](/admin).
 
-Then go to `Tools` > `Change administration password`.
+Then go to Tools > Change administration password.
 
 
-##Command line
+## Using the command line interface
+
 
 ```bash
 yunohost tools adminpw

change_admin_password_fr.md

@@ -1,26 +1,21 @@
 # Changer le mot de passe d’administration
 
-Pour des raisons de sécurité vous pouvez avoir besoin de changer votre mot de passe d’administration. Pour cela, deux méthodes sont possibles.
+Vous voudrez peut-être changer votre mot de passe d'administrateur pour des raisons de sécurité ou parce que vous l'avez oublié.
 
-<div class="alert alert-warning">
+Si vous avez oublié votre mot de passe ou si vous ne pouvez pas vous connecter en utilisant l'utilisateur `admin`, vous
-<span class="glyphicon glyphicon-warning-sign"></span>
+pouvez peut-être encore changer le mot de passe en vous connectant en tant que "root" sur
-Le mot de passe d’administration actuel est **requis** pour effectuer cette modification.
+SSH (à partir de votre réseau local ! ou en utilisant un mode rescure si vous êtes sur un VPS...)
-</div>
 
-##Administration web
+## Sur l'interface d'administration web
 
-Premièrement, connectez-vous à [l’administration web](/admin).
+1. Connectez-vous à [l’administration web](/admin).
+2. Allez dans la section Outis > Changer le mot de passe d’administration.
 
-Puis allez dans la section `Outils` > `Changer le mot de passe d’administration`.
 
-##Ligne de commande
+## En ligne de commande
+
 
 ```bash
 yunohost tools adminpw
 ```
 
-Si vous avez oublié votre mot de passe, utilisez plutôt:
-
-```bash
-yunohost-reset-ldap-password
-```

copy_image.md

@@ -1,47 +0,0 @@
-# Flashing an SD card
-
-Now that you download the YunoHost image, you have to copy its content to an SD
-card. This step is also sometimes called 'flashing' the SD card.
-
-<div class="alert alert-warning" markdown="1">
-In the context of self-hosting, it is recommended that your SD card be at least
-8 GB (to have a reasonable space available for the system and a few data) and at 
-least Class 10 (to ensure reasonable performances).
-</div>
-
-<img src="/images/sdcard.jpg" width=150><img src="https://yunohost.org/images/micro-sd-card.jpg">
-
-### With Etcher
-
-Download <a href="https://etcher.io/" target="_blank">Etcher</a> for your
-operating system and install it.
-
-<img src="/images/etcher.gif">
-
-Plug your SD card, select your YunoHost image and click "Flash"
-
-### With `dd`
-
-If you are on Linux / Mac and know your way around command line, you may also
-flash your SD card with `dd`. You can identify which device corresponds to your
-SD card with `fdisk -l` or `lsblk`. Assuming your SD card is `/dev/mmcblk0` (be
-careful !!), you may run :
-
-```bash
-dd if=/path/to/yunohost.img of=/dev/mmcblk0
-```
-
-## Expand the root partition <small>(optional)</small>
-
-<div class="alert alert-warning" markdown="1">
-This step is optional as it should be performed automatically during the first
-boot on recent images.
-</div>
-
-By default, the root partition of your SD card is very small.    
-You can resize it by using software like `resize2fs` (command-line) or `gparted`
-(graphical).
-
-<img src="/images/gparted.jpg" style="max-width:100%;border-radius: 5px;border: 1px solid rgba(0,0,0,0.15);box-shadow: 0 5px 15px rgba(0,0,0,0.35);">
-
-<p class="text-muted">Preview of the Gparted window</p>

copy_image_es.md

@@ -1,39 +0,0 @@
-# Flashear una tarjeta SD
-
-Ahora que has descargado la imagen de Yunohost, tienes que copiar su contenido en una tarjeta SD. Esta etapa también puede llamarse 'flashear' la tarjeta SD.
-
-<div class="alert alert-warning" markdown="1">
-En el marco del self-hosting / auto-alojamiento, está recomendado que tu tarjeta SD tenga una capacidad de por lo menos 8 Go (para diponer de suficientemente espacio para el sistema y un poco de datos) y esté al menos certificada de clase 10 (para tener bueno rendimiento).
-</div>
-
-<img src="/imagen/sdcard.jpg" width=150><img src="https://yunohost.org/images/micro-sd-card.jpg">
-
-### Con Etcher
-
-Descarga <a href="https://etcher.io/" target="_blank">Etcher</a> para tu sistema operativo, e instálalo.
-
-<img src="/images/etcher.gif">
-
-Conecta tu tarjeta SD, selecciona tu imagen Yunohost y luego haz clic en 'Flash'.
-
-### Con `dd`
-
-Si estás en Linux / Mac y que estás cómodo con la línea de comandos, también puedes flashear tu tarjeta SD con el comando `dd`. Empieza por identificar el periférico que corresponde a tu tarjeta SD con `fdisk -l` o
-`lsblk`. Suponiendo que tu tarjeta SD sea `/dev/mmcblk0` (¡ ten cuidado
-!), puedes iniciar :
-
-```bash
-dd if=/chemin/vers/yunohost.img of=/dev/mmcblk0
-```
-
-## Extiende la partición root <small>(optionnel)</small>
-
-<div class="alert alert-warning" markdown="1">
-Esta etapa es opcional porque normalmente la realiza automáticamente el sistema durante el primer inicio sobre las imágenes recientes.
-</div>
-
-Por defecto, la partición root instalada en tu tarjeta SD con el comando `dd` es muy pequeña. Puedes redimensionarla con un programa como `resize2fs` (línea de comandos) o `Gparted` (interfaz gráfica) extendiendo la partición ext4 al máximo de modo a utilizar todo el espacio que no está asignado.
-
-<img src="/images/gparted.jpg" style="max-width:100%;border-radius: 5px;border: 1px solid rgba(0,0,0,0.15);box-shadow: 0 5px 15px rgba(0,0,0,0.35);">
-
-<p class="text-muted">Vistazo de la interfaz de Gparted</p>

copy_image_fr.md

@@ -1,52 +0,0 @@
-# Flasher une carte SD
-
-Maintenant que vous avez téléchargé l'image de YunoHost, il vous faut copier son
-contenu sur une carte SD. Cette étape est aussi souvent appelé 'flasher' la
-carte SD.
-
-<div class="alert alert-warning" markdown="1">
-Dans le contexte de l'auto-hébergement, il est recommandé que votre carte SD
-fasse au moins 8 Go (pour disposer d'un espace raisonnable pour le système et
-quelques données) et soit au moins certifiée classe 10 (pour avoir des
-performances raisonnables).
-</div>
-
-<img src="/images/sdcard.jpg" width=150><img src="https://yunohost.org/images/micro-sd-card.jpg">
-
-### Avec Etcher
-
-Télécharger <a href="https://etcher.io/" target="_blank">Etcher</a> pour votre
-système d'exploitation, et installez-le.
-
-<img src="/images/etcher.gif">
-
-Connectez votre carte SD, sélectionnez votre image YunoHost, puis cliquez sur
-'Flash'.
-
-### Avec `dd`
-
-Si vous êtes sous Linux / Mac et que vous êtes à l'aise avec la ligne de
-commande, vous pouvez aussi flasher votre carte SD avec `dd`. Commencez par
-identifier le périphérique correspondant à votre carte SD avec `fdisk -l` ou
-`lsblk`. En supposant que votre carte SD soit `/dev/mmcblk0` (faites attention
-!), vous pouvez lancer :
-
-```bash
-dd if=/chemin/vers/yunohost.img of=/dev/mmcblk0
-```
-
-## Étendre la partition root <small>(optionnel)</small>
-
-<div class="alert alert-warning" markdown="1">
-Cette étape est optionnelle car elle est normalement effectuée automatiquement
-par le système lors du premier démarrage sur les images récentes.
-</div>
-
-Par défaut, la partition root installée sur votre carte SD avec la commande `dd`
-est très petite.   Vous pouvez la redimensionner avec un logiciel comme
-`resize2fs` (ligne de commande) ou `Gparted` (interface graphique) en étendant
-la partition ext4 au maximum de façon à utiliser tout l’espace non alloué.
-
-<img src="/images/gparted.jpg" style="max-width:100%;border-radius: 5px;border: 1px solid rgba(0,0,0,0.15);box-shadow: 0 5px 15px rgba(0,0,0,0.35);">
-
-<p class="text-muted">Aperçu de l’interface de Gparted</p>

dns_resolver.md

@@ -1,30 +0,0 @@
-# YunoHost DNS Resolver
-
-+<div class="alert alert-danger">This page is deprecated / obsolete. Information it contains should be updated (or should be removed).</div>
-
-### Presentation
-YunoHost provide a DNS service for DNS name resolution. Usually, your server is not configured to use it, it's your ISP DNS. For instance, for the Free ISP with Freebox router the DNS resolver IP is `192.168.0.254`.
-
-How to known: watch the file `/etc/resolv.conf`. This file is not modifiable because it is rewriten by the DHCP service. A DHCP client is configured, it requests the router to get DNS resolver IPs. 
-This IPs is provided by your ISP.
-
-### Configuration
-To use YunoHost DNS resolver of your server, modify your DHCP configuration client: remove DNS name server request, and add static IP of your server `127.0.0.1`.
-
-Edit the file `/etc/dhcp/dhclient.conf`, add the line `supersede` and remove in the line `request` the word `domain-name-servers`:
-```bash
-supersede domain-name-servers 127.0.0.1, 192.168.0.254;
-request subnet-mask, broadcast-address, time-offset, routers,
-        domain-name, domain-search, host-name,
-        dhcp6.name-servers, dhcp6.domain-search,
-        netbios-name-servers, netbios-scope, interface-mtu,
-        rfc3442-classless-static-routes, ntp-servers;
-```
-Apply this modification by rebooting the DNS server:
-
-```bash
-service dnsmasq restart
-```
-
-(TODO: It's possible to restart a service to take into account the modification -DHCP?-, but didn't work for me).
-It's possible to do same modification in all machine in local network by replacing *127.0.0.1* by IP server.

dns_resolver_fr.md

@@ -1,32 +0,0 @@
-# Résolveur DNS de YunoHost
-
-<div class="alert alert-danger">Cette page est dépréciée / obsolète. Les informations présentées ont besoin d'être mise à jour (ou doivent être retirée).</div>
-
-### Présentation
-YunoHost est installé avec un service DNS pour la résolution des noms de domaine. En général, votre serveur n’est pas configuré, c’est celui de votre FAI.
-Par exemple pour une Freebox la résolution se fait par l’adresse `192.168.0.254`.
-
-Comment savoir ? Regarder le contenu du fichier `/etc/resolv.conf`. Ce fichier n’est pas modifiable car il est réécrit par le service DHCP.
-Un client DHCP est configuré, celui-ci interroge votre routeur pour les adresses IP de vos serveurs de résolution de DNS. Ces IPs sont fournis par votre FAI.
-
-### Configuration
-Afin d’utiliser le résolveur DNS de votre instance YunoHost, il faut modifier la configuration DHCP pour ne pas faire de requêtes à votre routeur. Il faut donc mettre de façon statique la nouvelle adresse à savoir dans ce cas `127.0.0.1`.
-
-Éditer le fichier `/etc/dhcp/dhclient.conf`, ajouter une ligne `supersede` et supprimer de la ligne `request` le mot `domain-name-servers` :
-```bash
-supersede domain-name-servers 127.0.0.1, 192.168.0.254;
-request subnet-mask, broadcast-address, time-offset, routers,
-        domain-name, domain-search, host-name,
-        dhcp6.name-servers, dhcp6.domain-search,
-        netbios-name-servers, netbios-scope, interface-mtu,
-        rfc3442-classless-static-routes, ntp-servers;
-```
-
-Afin de prendre en compte la modification, redémarrer le serveur DNS :
-
-```bash
-service dnsmasq restart
-```
-
-(TODO : il doit être possible de reconfigurer à chaud, mais ça n’a pas fonctionné).
-Il est possible de faire la même modification sur toutes vos machines du réseau local en remplaçant 127.0.0.1 par l’IP de votre serveur.

doc_markdown_guide.md

@@ -7,7 +7,7 @@ Markdown allows text to be formatted using tags, it allows *human* reading of th
 ## The different levels of titles
 
 By writing titles as follows:
-```Markdown
+```markdown
 # Level 1 title
 ## Level 2 title
 ### Level 3 title

groups_and_permissions.md

@@ -29,7 +29,7 @@ The existing groups are listed at the top of the *groups and permissions* page.
 
 To list the currently existing groups in CLI :
 
-```bash
+```shell
 $ yunohost user group list
 groups:
   all_users:
@@ -49,7 +49,7 @@ To create a new group, simply click on the "New Group" button at the top of the
 
 In CLI, to create a new group called `yolo_crew`
 
-```bash
+```shell
 $ yunohost user group create yolo_crew
 ```
 
@@ -65,7 +65,7 @@ To remove a user, click on the cross next to their username, in the group panel.
 
 In CLI, use the following command to add `charlie` and `delphine`to the `yolo_crew` group:
 
-```bash
+```shell
 $ yunohost user group update yolo_crew --add charlie delphine
 ```
 
@@ -73,7 +73,7 @@ $ yunohost user group update yolo_crew --add charlie delphine
 
 Now in the group list we should see :
 
-```bash
+```shell
 $ yunohost user group list
 groups:
   all_users:
@@ -96,7 +96,7 @@ To delete a group, click on the red cross on the top right of the group panel. Y
 
 To delete the group `yolo_crew` in CLI, you may run
 
-```bash
+```shell
 $ yunohost user group delete yolo_crew
 ```
 
@@ -113,7 +113,7 @@ The groups page lists the permissions given to each group, including the special
 
 To list permissions and corresponding accesses in CLI:
 
-```bash
+```shell
 $ yunohost user permission list
 permissions:
   mail.main:
@@ -138,7 +138,7 @@ To add a permission to a group, simply click the "+" button in the group panel,
 
 To allow a group to access the wordpress admin interface in CLI:
 
-```bash
+```shell
 $ yunohost user permission update wordpress.admin --add yolo_crew
 ```
 
@@ -148,13 +148,13 @@ Note that you can also allow a single user, by using the specific panel at the b
 
 or in CLI:
 
-```bash
+```shell
 $ yunohost user permission update wordpress.admin --add alice
 ```
 
 And now we may see that both the YoloCrew and Alice have access to the wordpress admin interface :
 
-```bash
+```shell
 $ yunohost user permission list
   [...]
   wordpress.admin:
@@ -166,7 +166,7 @@ $ yunohost user permission list
 
 Note that, for example, if we want to restrict permission for email so that only Bob is allowed to email, we should also remove `all_users` from the permission, by deleting it from the `all_users` group panel, or in CLI :
 
-```bash
+```shell
 $ yunohost user permission update mail --remove all_users --add bob
 ```
 
@@ -180,13 +180,13 @@ Installing an app creates the permission `app.main` with `all_users` allowed by
 
 If you wish to make the application publicly available, instead of the old `unprotected_urls` mechanism, you should give access to the special group `visitors`:
 
-```bash
+```shell
 ynh_permission_update --permission "main" --add visitors
 ```
 
 If you wish to create a custom permission for your app (e.g. to restrict access to an admin interface) you may use the following helpers:
 
-```bash
+```shell
 ynh_permission_create --permission "admin" --url "/admin" --allowed "$admin_user"
 ```
 

groups_and_permissions_fr.md

@@ -28,7 +28,7 @@ Les groupes existants sont listés en haut de la page *groupes et autorisations*
 Pour obtenir la liste des groupes existants en CLI :
 
 
-```bash
+```shell
 $ yunohost user group list
 groups:
   all_users:
@@ -47,7 +47,7 @@ Pour créer un nouveau groupe, il suffit de cliquer sur le bouton "Nouveau group
 
 Dans la CLI, pour créer un nouveau groupe appelé `yolo_crew`, il faut utiliser
 
-```bash
+```shell
 $ yunohost user group create yolo_crew
 ```
 
@@ -62,7 +62,7 @@ Pour supprimer un utilisateur, cliquez sur la croix à côté de son nom d'utili
 
 En CLI, utilisez la commande suivante pour ajouter `charlie` et `delphine` au groupe `yolo_crew` :
 
-```bash
+```shell
 $ yunohost user group update yolo_crew --add charlie delphine
 ```
 
@@ -70,7 +70,7 @@ $ yunohost user group update yolo_crew --add charlie delphine
 
 Dans la liste des groupes, nous devrions voir :
 
-```bash
+```shell
 $ yunohost user group list
 groups:
   all_users:
@@ -93,7 +93,7 @@ Pour supprimer un groupe, cliquez sur la croix rouge en haut à droite du pannea
 
 Pour supprimer le groupe `yolo_crew` dans CLI, vous pouvez exécuter
 
-```bash
+```shell
 $ yunohost user group delete yolo_crew
 ```
 
@@ -109,7 +109,7 @@ La page des groupes liste les permissions données à chaque groupe, y compris l
 ![](./images/groups_default-with-permissions.png)
 
 Pour répertorier les permissions et les accès correspondants en CLI :
-```bash
+```shell
 $ yunohost user permission list
 permissions:
   mail.main:
@@ -133,7 +133,7 @@ Pour ajouter une permission à un groupe, il suffit de cliquer sur le bouton "+"
 
 Pour permettre à un groupe d'accéder à l'interface d'administration de wordpress via la CLI :
 
-```bash
+```shell
 $ yunohost user permission update wordpress.admin --add yolo_crew
 ```
 
@@ -143,13 +143,13 @@ Notez que vous pouvez également autoriser un seul utilisateur, en utilisant le
 
 ou en CLI :
 
-```bash
+```shell
 $ yunohost user permission update wordpress.admin --add alice
 ```
 
 Et maintenant, nous pouvons voir que YoloCrew et Alice ont tous deux accès à l'interface d'administration de Wordpress :
 
-```bash
+```shell
 $ yunohost user permission list
   [...]
   wordpress.admin:
@@ -163,7 +163,7 @@ Notez que, par exemple, si nous voulons restreindre la permission pour le courri
 afin que seul Bob soit autorisé à envoyer des courriels, nous devons également supprimer `all_users` 
 de la permission, en la supprimant du panneau de groupe `all_users`, ou en CLI :
 
-```bash
+```shell
 $ yunohost user permission update mail --remove all_users --add bob
 ```
 

install_on_arm_board.md

@@ -29,7 +29,7 @@ YunoHost doesn't yet support ARM64 boards. For more information, see [this issue
 
 <a class="btn btn-lg btn-default" href="/images">0. Download the pre-installed image for your board</a><br><small>If no pre-installed image exists for your board, you can follow the instructions to "Install on top of ARMbian"</small>
 
-<a class="btn btn-lg btn-default" href="/copy_image">1. Flash the SD card with the image</a>
+<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">1. Flash the SD card with the image</a>
 
 <a class="btn btn-lg btn-default" href="/plug_and_boot">2. Power up the board and let it boot</a>
 
@@ -43,7 +43,7 @@ YunoHost doesn't yet support ARM64 boards. For more information, see [this issue
 
 <a class="btn btn-lg btn-default" href="https://www.armbian.com/download/">0. Download the ARMbian image for your board</a>
 
-<a class="btn btn-lg btn-default" href="/copy_image">1. Flash the SD card with the image</a>
+<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">1. Flash the SD card with the image</a>
 
 <a class="btn btn-lg btn-default" href="/plug_and_boot">2. Plug & boot</a>
 

install_on_arm_board_es.md

@@ -27,7 +27,7 @@ YunoHost todavía no es compatible con las tarjetas ARM64. Para obtener más inf
 
 <a class="btn btn-lg btn-default" href="/images">0. Descargar la imagen pre-instalada para tu tarjeta ARM</a><br><small>Si no existe una imagen dedicada a tu tarjeta, puedes seguir la sección "Instalación encima de ARMbian".</small>
 
-<a class="btn btn-lg btn-default" href="/copy_image">1. Poner la imagen en tu tarjeta SD</a>
+<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">1. Poner la imagen en tu tarjeta SD</a>
 
 <a class="btn btn-lg btn-default" href="/plug_and_boot">2. Conectar y encender</a>
 
@@ -41,7 +41,7 @@ YunoHost todavía no es compatible con las tarjetas ARM64. Para obtener más inf
 
 <a class="btn btn-lg btn-default" href="https://www.armbian.com/download/">0. Descargar la imagen ARMbian para tu tarjeta ARM</a>
 
-<a class="btn btn-lg btn-default" href="/copy_image">1. Poner la imagen en tu tarjeta SD</a>
+<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">1. Poner la imagen en tu tarjeta SD</a>
 
 <a class="btn btn-lg btn-default" href="/plug_and_boot">2. Conectar y encender</a>
 

install_on_arm_board_fr.md

@@ -27,7 +27,7 @@ YunoHost ne supporte pour le moment pas les cartes ARM64. Pour plus d'informatio
 
 <a class="btn btn-lg btn-default" href="/images">0. Télécharger l'image pré-installée pour votre carte ARM</a><br><small>Si il n'existe pas d'image pré-installée pour votre carte, vous pouvez suivre la section "Installation par dessus ARMbian".</small>
 
-<a class="btn btn-lg btn-default" href="/copy_image">1. Flasher la carte SD avec l'image</a>
+<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">1. Flasher la carte SD avec l'image</a>
 
 <a class="btn btn-lg btn-default" href="/plug_and_boot">2. Brancher la carte et la laisser démarrer</a>
 
@@ -41,7 +41,7 @@ YunoHost ne supporte pour le moment pas les cartes ARM64. Pour plus d'informatio
 
 <a class="btn btn-lg btn-default" href="https://www.armbian.com/download/">0. Télécharger l'image ARMbian pour votre carte ARM</a>
 
-<a class="btn btn-lg btn-default" href="/copy_image">1. Flasher la carte SD avec l'image</a>
+<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">1. Flasher la carte SD avec l'image</a>
 
 <a class="btn btn-lg btn-default" href="/plug_and_boot">2. Brancher & démarrer</a>
 

install_on_raspberry.md

@@ -25,7 +25,7 @@ Before setting up a server at home, it is recommended that you know the [possibl
 
 <a class="btn btn-lg btn-default" href="/images">0. Download the pre-installed image for Raspberry Pi</a>
 
-<a class="btn btn-lg btn-default" href="/copy_image">1. Flash the SD card with the image</a>
+<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">1. Flash the SD card with the image</a>
 
 <a class="btn btn-lg btn-default" href="/plug_and_boot">2. Power up the board and let it boot</a>
 

install_on_raspberry_de.md

@@ -25,7 +25,7 @@ Vor der Einrichtung eines Servers zuhause ist es empfehlenswert [mögliche Einsc
 
 <a class="btn btn-lg btn-default" href="/images">0. Download the pre-installed image for Raspberry Pi</a>
 
-<a class="btn btn-lg btn-default" href="/copy_image">1. Flash the SD card with the image</a>
+<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">1. Flash the SD card with the image</a>
 
 <a class="btn btn-lg btn-default" href="/plug_and_boot">2. Plug & boot</a>
 

install_on_raspberry_es.md

@@ -25,7 +25,7 @@ Antes de alojar tu propio servidor en tu casa, te recomendamos que consultes las
 
 <a class="btn btn-lg btn-default" href="/images">1. Descargar la imagen para Raspberry Pi</a>
 
-<a class="btn btn-lg btn-default" href="/copy_image">2. Poner la imagen en tu tarjeta SD</a>
+<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">2. Poner la imagen en tu tarjeta SD</a>
 
 <a class="btn btn-lg btn-default" href="/plug_and_boot">3. Conectar y encender</a>
 

install_on_raspberry_fr.md

@@ -25,7 +25,7 @@ Avant d'héberger un serveur chez vous, il est recommandé de prendre connaissan
 
 <a class="btn btn-lg btn-default" href="/images">1. Télécharger l'image pour Raspberry Pi</a>
 
-<a class="btn btn-lg btn-default" href="/copy_image">2. Flasher la carte SD avec l'image</a>
+<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">2. Flasher la carte SD avec l'image</a>
 
 <a class="btn btn-lg btn-default" href="/plug_and_boot">3. Brancher la carte et la laisser démarrer</a>
 

install_on_raspberry_it.md

@@ -1,3 +0,0 @@
-# Installa YunoHost su Raspberry Pi
-
-*Consulta la guida completa in inglese [qui](/install_on_raspberry)*

moving_app_folder.md

@@ -0,0 +1,38 @@
+# Moving an app folder to a different storage
+
+Applications folder are (*usually*) located in `/var/www/$appname`
+
+If an application folder is expected to get bigger because of the amount of data
+it contains, it might be relevant to move it to another storage (like an
+external hard drive).
+
+Here's a summary of how to do this the application wordpress. Here, is is assumed that
+[you already mounted the external hard-drive](/external_storage).
+
+#### 1. Move the entire wordpress folder to an external hard drive
+
+```shell
+mv /var/www/wordpress /media/externalharddrive/
+```
+
+#### 2. Create a symbolic link 
+
+So that programs looking for files in /var/www/wordpress will actually take them from the harddrive
+
+```shell
+ln -s /media/externalharddrive/wordpress /var/www/wordpress
+```
+
+#### 3. Tweak permissions (maybe?)
+
+After this, note that you may need to tweak the permissions of `/media/externalharddrive` so that `www-data` (or the user corresponding to the app) is able to read through the folder... Something like :
+ 
+```shell
+chgrp www-data /media/externalharddrive
+chmod g+rx /media/externalharddrive
+
+```
+
+(but it depends on your exact setup... Please update this doc page if you figure
+out what to do exactly)
+

packaging_apps_nginx_conf.md

@@ -4,7 +4,7 @@ This tutorial aim to help setup Nginx configuration for application packaging.
 #### Nginx configuration
 Configuration must be in `conf/nginx.conf`. We must use **FastCGI** or a **proxy_pass** following the application:
 * **FastCGI** is used with PHP applications:
-```bash
+```nginx
 location YNH_EXAMPLE_PATH {
   alias YNH_WWW_PATH ;
   if ($scheme = http) {
@@ -28,7 +28,7 @@ location YNH_EXAMPLE_PATH {
 ```
 
 * **`proxy_pass`** in Python, Node.js, Go and Java applications:
-```bash
+```nginx
 location YNH_EXAMPLE_PATH/ {
        rewrite                ^YNH_EXAMPLE_PATH$ YNH_EXAMPLE_PATH/ permanent;
        proxy_pass             http://YNH_EXEMPLE_DOMAIN:YNH_EXAMPLE_PORT/;

packaging_apps_nginx_conf_fr.md

@@ -4,7 +4,7 @@ Ce tutoriel a pour but d’aider à la mise en place d’une configuration Nginx
 #### Configuration Nginx
 La configuration doit être mise dans `conf/nginx.conf`. Il s’agira d’utiliser **FastCGI** ou un **proxy_pass** suivant l’application :
 * **FastCGI** est utilisé dans les applications PHP :
-```bash
+```nginx
 location YNH_EXAMPLE_PATH {
   alias YNH_WWW_PATH ;
   if ($scheme = http) {
@@ -28,7 +28,7 @@ location YNH_EXAMPLE_PATH {
 ```
 
 * **`proxy_pass`** dans le cas d’applications Python, Node.js, Go et Java :
-```bash
+```nginx
 location YNH_EXAMPLE_PATH/ {
        rewrite                ^YNH_EXAMPLE_PATH$ YNH_EXAMPLE_PATH/ permanent;
        proxy_pass             http://YNH_EXEMPLE_DOMAIN:YNH_EXAMPLE_PORT/;

packaging_apps_scripts.md

@@ -45,7 +45,7 @@ For example, if in the manifest we have a question like this
         "de": "Wählen Sie bitte einen Domain für OpenSondage"
     },
     "example": "domain.org"
-},
+}
 ```
 
 The name of the question is `domain` so in the script we can access it with YNH_APP_ARG_DOMAIN. The usage is to create a shorter name in the script like this:

security.md

@@ -88,7 +88,7 @@ nano /etc/fail2ban/jail.d/my_ssh_port.conf
 
 and you can then fill it in with
 
-```bash
+```ini
 [sshd]
 port = <your_ssh_port>
 

security_fr.md

@@ -101,7 +101,7 @@ nano /etc/fail2ban/jail.d/my_ssh_port.conf
 
 et de le compléter ainsi :
 
-```bash
+```ini
 [sshd]
 port = <votre_numero_de_port_ssh>