Merge branch 'master' into patch-1

pages/01.overview/10.what_is_yunohost/what_is_yunohost.it.md

@@ -13,45 +13,44 @@ YunoHost è un **sistema operativo** che mira a rendere il più semplice possibi
 
 ## Caratteristiche
 
-- ![](image://icon-debian.png?resize=32&classes=inline) Based on Debian;
+- ![](image://icon-debian.png?resize=32&classes=inline) Basato su Debian; 
-- ![](image://icon-tools.png?resize=32&classes=inline) Administer your server through a **friendly web interface** ;
+- ![](image://icon-tools.png?resize=32&classes=inline) Amministra il tuo server attraverso **un'interfaccia web amichevole** ;
-- ![](image://icon-package.png?resize=32&classes=inline) Deploy **apps in just a few clicks**;
+- ![](image://icon-package.png?resize=32&classes=inline) Installa le **applicazioni in pochi clic**;
-- ![](image://icon-users.png?resize=32&classes=inline) Manage **users** <small>(based on LDAP)</small>;
+- ![](image://icon-users.png?resize=32&classes=inline) Gestisci **gli utenti ** <small>(basato su LDAP)</small>;
-- ![](image://icon-globe.png?resize=32&classes=inline) Manage **domain names**;
+- ![](image://icon-globe.png?resize=32&classes=inline) Gestisci **i nomi di dominio**;
-- ![](image://icon-medic.png?resize=32&classes=inline) Create and restore **backups**;
+- ![](image://icon-medic.png?resize=32&classes=inline) Crea e ripristina  **i backup**;
-- ![](image://icon-door.png?resize=32&classes=inline) Connect to all apps simultaneously through the **user portal** <small>(NGINX, SSOwat)</small>;
+- ![](image://icon-door.png?resize=32&classes=inline) Connettiti contemporaneamente a tutte le applicazioni  attraverso **il portale utente** <small>(NGINX, SSOwat)</small>;
-- ![](image://icon-mail.png?resize=32&classes=inline) Includes a **full e-mail stack** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
+- ![](image://icon-mail.png?resize=32&classes=inline) Include uno **stack di posta elettronica completo** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
-- ![](image://icon-messaging.png?resize=32&classes=inline)... as well as **an instant messaging server** <small>(XMPP)</small>;
+- ![](image://icon-messaging.png?resize=32&classes=inline)... e anche un **server di messaggistica istantanea** <small>(XMPP)</small>;
-- ![](image://icon-lock.png?resize=32&classes=inline) Manages **SSL certificates** <small>(based on Let's Encrypt)</small> ;
+- ![](image://icon-lock.png?resize=32&classes=inline) Gestisce i **certificati SSL** <small>(basati su Let's Encrypt)</small> ;
-- ![](image://icon-shield.png?resize=32&classes=inline)... and **security systems** <small>(Fail2ban, yunohost-firewall)</small>;
+- ![](image://icon-shield.png?resize=32&classes=inline)... e i **sistemi di sicurezza** <small>(Fail2ban, yunohost-firewall)</small>;
 
-## Origin
+## Origine
+YunoHost è stata creata nel febbraio 2012 dopo qualcosa del genere:
 
-YunoHost was created in February 2012 after something like this:
+<blockquote><p>"Merda, sono troppo pigro per riconfigurare il mio server di posta... Beudbeud, come sei riuscito a far funzionare il tuo piccolo server con LDAP?"</p>
+<small>Kload, Febbraio 2012</small></blockquote>
 
-<blockquote><p>"Shit, I'm too lazy to reconfigure my mail server... Beudbeud, how were you able to get your little server running with LDAP?"</p>
+Tutto ciò che serviva era un'interfaccia di amministrazione per il server di Beudbeud per creare qualcosa di utilizzabile, così Kload ha deciso di svilupparne una. Alla fine, dopo aver automatizzato diverse configurazioni e aver inserito alcune applicazioni web, YunoHost versione 1 è stato completato.
-<small>Kload, February 2012</small></blockquote>
 
-All that was needed was an admin interface for Beudbeud's server to make something usable, so Kload decided to develop one. Finally, after automating several configs and packaging in some web apps, YunoHost v1 was finished.
+Notando il crescente entusiasmo intorno a YunoHost e al self-hosting in generale, gli sviluppatori originari e i nuovi collaboratori hanno deciso di iniziare a lavorare alla versione 2, una versione più estensibile, più potente, più facile da usare e che prepara una bella tazza di caffè equo-solidale per gli elfi della Lapponia.
 
-Noting the growing enthusiasm around YunoHost and around self-hosting in general, the original developers along with new contributors decided to start work on version 2, a more extensible, more powerful, more easy-to-use, and at that, one that makes a nice cup of fair-trade coffee for the elves of Lapland.
+Il nome **YunoHost** deriva dal gergo "Y U NO Host". Il [meme Internet](https://en.wikipedia.org/wiki/Internet_meme) dovrebbe illustrarlo: 
-
-The name **YunoHost** comes from the jargon "Y U NO Host". The [Internet meme](https://en.wikipedia.org/wiki/Internet_meme) should illustrate it:
 ![](image://dude_yunohost.jpg)
 
-## What YunoHost is not?
+## Cosa non è YunoHost?
 
-Even if YunoHost can handle multiple domains and multiple users, it is **not meant to be a mutualized system**.
+Anche se YunoHost è in grado di gestire più domini e più utenti, **non è pensato per essere un sistema mutualizzato.**.
 
-First, the software is too young, not tested at scale and thus probably not optimized well enough for hundreds of users at the same time. With that said, we do not want to lead the software in that direction. Virtualization democratizes, and its usage is recommended since it is a more watertight way to achieve mutualization than a "full-stack" system like YunoHost.
+In primo luogo, il software è troppo giovane, non è stato testato su larga scala e quindi probabilmente non è sufficientemente ottimizzato per centinaia di utenti contemporaneamente. Detto questo, non vogliamo sviluppare il software in quella direzione. La virtualizzazione è sempre più diffusa e il suo utilizzo è consigliato in quanto è un modo più sicuro per ottenere la mutualizzazione rispetto a un sistema "full-stack" come YunoHost.
 
-You can host your friends, your family and your company safely and with ease, but you must **trust your users**, and they must trust you above all. If you want to provide YunoHost services for unknown persons anyway, a full VPS per user will be just fine, and we believe a better way to go.
+Potete ospitare i vostri amici, la vostra famiglia e la vostra azienda in tutta sicurezza e facilità, ma dovete **fidarvi dei vostri utenti**, e soprattutto loro devono fidarsi di voi. Se volete comunque fornire i servizi YunoHost a persone sconosciute, un VPS completo per utente andrà benissimo e riteniamo che sia una soluzione migliore.
 
-## Artworks
+## Logo
 
-Black and white YunoHost PNG logo by ToZz (400 × 400 px):
+Il logo PNG di YunoHost in bianco e nero di ToZz (400 × 400 px):
 
 ![](image://ynh_logo_black_300dpi.png?resize=220)
 ![](image://ynh_logo_white_300dpi.png?resize=220&id=whitelogo)
 
-Licence: CC-BY-SA 4.0
+Licenza: CC-BY-SA 4.0

pages/02.administer/10.install/05.images/images.ar.md

@@ -11,8 +11,7 @@ routes:
 <div id="cards-list">
 </div>
 </div>
-
+<template id="image-template">
-<script type="text/template" id="image-template">
     <div id="{id}" class="card panel panel-default">
         <div class="panel-body text-center">
             <h3>{name}</h3>
@@ -26,10 +25,10 @@ routes:
             <div class="flex-child annotation"><a href="{file}.sig">[fa=tag] Signature</a></div>
         </div>
         <div class="btn-group" role="group">
-            <a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12"><span class="glyphicon glyphicon-download-alt" aria-hidden="true"></span> تنزيل <small>{version}</small></a>
+            <a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12"><span class="glyphicon glyphicon-download-alt" aria-hidden="true"></span> Download <small>{version}</small></a>
         </div>
     </div>
-</script>
+</template>
 
 
 <script>
@@ -48,13 +47,12 @@ $(document).ready(function () {
              .replace('{id}', infos.id)
              .replace('{name}', infos.name)
              .replace('{comment}', infos.comment || "&nbsp;")
+             .replace('%7Bimage%7D', infos.image)
              .replace('{image}', infos.image)
              .replace('{version}', infos.version);
- 
+            if (!infos.file.startsWith("http"))
-            if (infos.file.startsWith("http"))
+                infos.file="https://build.yunohost.org/"+infos.file;
-                html = html.replace(/{file}/g, infos.file);
+            html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
-            else
-                html = html.replace(/{file}/g, "https://build.yunohost.org/"+infos.file);
 
             if ((typeof(infos.has_sig_and_sums) !== 'undefined') && infos.has_sig_and_sums == false)
             {

pages/02.administer/10.install/05.images/images.de.md

@@ -20,7 +20,7 @@ N B : Auch wenn das Image nicht der neuesten Version von YunoHost entspricht, k
 </div>
 </div>
 
-<script type="text/template" id="image-template">
+<template id="image-template">
     <div id="{id}" class="card panel panel-default">
         <div class="panel-body text-center">
             <h3>{name}</h3>
@@ -34,22 +34,20 @@ N B : Auch wenn das Image nicht der neuesten Version von YunoHost entspricht, k
             <div class="flex-child annotation"><a href="{file}.sig">[fa=tag] Signature</a></div>
         </div>
         <div class="btn-group" role="group">
-            <a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12">[fa=download] Download <small>{version}</small></a>
+            <a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12"><span class="glyphicon glyphicon-download-alt" aria-hidden="true"></span> Download <small>{version}</small></a>
         </div>
     </div>
-</script>
+</template>
+
 
 <script>
 /*
 ###############################################################################
-  Script that loads the infos from JavaScript and creates the corresponding
+  Script that loads the infos from javascript and creates the corresponding
   cards
 ###############################################################################
 */
 $(document).ready(function () {
-
-    $(".javascriptDisclaimer").hide();
-
     console.log("in load");
     $.getJSON('https://build.yunohost.org/images.json', function (images) {
         $.each(images, function(k, infos) {
@@ -58,13 +56,12 @@ $(document).ready(function () {
              .replace('{id}', infos.id)
              .replace('{name}', infos.name)
              .replace('{comment}', infos.comment || "&nbsp;")
+             .replace('%7Bimage%7D', infos.image)
              .replace('{image}', infos.image)
              .replace('{version}', infos.version);
-
+            if (!infos.file.startsWith("http"))
-            if (infos.file.startsWith("http"))
+                infos.file="https://build.yunohost.org/"+infos.file;
-                html = html.replace(/{file}/g, infos.file);
+            html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
-            else
-                html = html.replace(/{file}/g, "https://build.yunohost.org/"+infos.file);
 
             if ((typeof(infos.has_sig_and_sums) !== 'undefined') && infos.has_sig_and_sums == false)
             {
@@ -77,3 +74,4 @@ $(document).ready(function () {
     });
 });
 </script>
+

pages/02.administer/10.install/05.images/images.es.md

@@ -19,8 +19,7 @@ N.B. : Incluso si la imagen no corresponde con la última versión de YunoHost,
 <div id="cards-list">
 </div>
 </div>
-
+<template id="image-template">
-<script type="text/template" id="image-template">
     <div id="{id}" class="card panel panel-default">
         <div class="panel-body text-center">
             <h3>{name}</h3>
@@ -34,10 +33,10 @@ N.B. : Incluso si la imagen no corresponde con la última versión de YunoHost,
             <div class="flex-child annotation"><a href="{file}.sig">[fa=tag] Signature</a></div>
         </div>
         <div class="btn-group" role="group">
-            <a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12"><span class="glyphicon glyphicon-download-alt" aria-hidden="true"></span> Télécharger <small>{version}</small></a>
+            <a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12"><span class="glyphicon glyphicon-download-alt" aria-hidden="true"></span> Download <small>{version}</small></a>
         </div>
     </div>
-</script>
+</template>
 
 
 <script>
@@ -56,13 +55,12 @@ $(document).ready(function () {
              .replace('{id}', infos.id)
              .replace('{name}', infos.name)
              .replace('{comment}', infos.comment || "&nbsp;")
+             .replace('%7Bimage%7D', infos.image)
              .replace('{image}', infos.image)
              .replace('{version}', infos.version);
- 
+            if (!infos.file.startsWith("http"))
-            if (infos.file.startsWith("http"))
+                infos.file="https://build.yunohost.org/"+infos.file;
-                html = html.replace(/{file}/g, infos.file);
+            html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
-            else
-                html = html.replace(/{file}/g, "https://build.yunohost.org/"+infos.file);
 
             if ((typeof(infos.has_sig_and_sums) !== 'undefined') && infos.has_sig_and_sums == false)
             {
@@ -76,3 +74,4 @@ $(document).ready(function () {
 });
 </script>
 
+

pages/02.administer/10.install/05.images/images.fr.md

@@ -25,8 +25,7 @@ Cette page requiert que Javascript soit activé pour s'afficher correctement :s.
 <div id="cards-list">
 </div>
 </div>
-
+<template id="image-template">
-<script type="text/template" id="image-template">
     <div id="{id}" class="card panel panel-default">
         <div class="panel-body text-center">
             <h3>{name}</h3>
@@ -43,7 +42,7 @@ Cette page requiert que Javascript soit activé pour s'afficher correctement :s.
             <a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12"><span class="glyphicon glyphicon-download-alt" aria-hidden="true"></span> Télécharger <small>{version}</small></a>
         </div>
     </div>
-</script>
+</template>
 
 
 <script>
@@ -62,13 +61,12 @@ $(document).ready(function () {
              .replace('{id}', infos.id)
              .replace('{name}', infos.name)
              .replace('{comment}', infos.comment || "&nbsp;")
+             .replace('%7Bimage%7D', infos.image)
              .replace('{image}', infos.image)
              .replace('{version}', infos.version);
- 
+            if (!infos.file.startsWith("http"))
-            if (infos.file.startsWith("http"))
+                infos.file="https://build.yunohost.org/"+infos.file;
-                html = html.replace(/{file}/g, infos.file);
+            html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
-            else
-                html = html.replace(/{file}/g, "https://build.yunohost.org/"+infos.file);
 
             if ((typeof(infos.has_sig_and_sums) !== 'undefined') && infos.has_sig_and_sums == false)
             {

pages/02.administer/10.install/05.images/images.md

@@ -25,8 +25,7 @@ This page requires Javascript enabled to display properly :s.
 <div id="cards-list">
 </div>
 </div>
-
+<template id="image-template">
-<script type="text/template" id="image-template">
     <div id="{id}" class="card panel panel-default">
         <div class="panel-body text-center">
             <h3>{name}</h3>
@@ -40,22 +39,20 @@ This page requires Javascript enabled to display properly :s.
             <div class="flex-child annotation"><a href="{file}.sig">[fa=tag] Signature</a></div>
         </div>
         <div class="btn-group" role="group">
-            <a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12">[fa=download] Download <small>{version}</small></a>
+            <a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12"><span class="glyphicon glyphicon-download-alt" aria-hidden="true"></span> Download <small>{version}</small></a>
         </div>
     </div>
-</script>
+</template>
+
 
 <script>
 /*
 ###############################################################################
-  Script that loads the infos from JavaScript and creates the corresponding
+  Script that loads the infos from javascript and creates the corresponding
   cards
 ###############################################################################
 */
 $(document).ready(function () {
-
-    $(".javascriptDisclaimer").hide();
-
     console.log("in load");
     $.getJSON('https://build.yunohost.org/images.json', function (images) {
         $.each(images, function(k, infos) {
@@ -64,13 +61,12 @@ $(document).ready(function () {
              .replace('{id}', infos.id)
              .replace('{name}', infos.name)
              .replace('{comment}', infos.comment || "&nbsp;")
+             .replace('%7Bimage%7D', infos.image)
              .replace('{image}', infos.image)
              .replace('{version}', infos.version);
- 
+            if (!infos.file.startsWith("http"))
-            if (infos.file.startsWith("http"))
+                infos.file="https://build.yunohost.org/"+infos.file;
-                html = html.replace(/{file}/g, infos.file);
+            html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
-            else
-                html = html.replace(/{file}/g, "https://build.yunohost.org/"+infos.file);
 
             if ((typeof(infos.has_sig_and_sums) !== 'undefined') && infos.has_sig_and_sums == false)
             {
@@ -83,3 +79,4 @@ $(document).ready(function () {
     });
 });
 </script>
+

pages/02.administer/10.install/install.fr.md

@@ -217,6 +217,8 @@ Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost :
 {% if at_home %}
 ## [fa=download /] Télécharger l'image {{image_type}}
 
+! Les liens vers les images sont actuellement cassés. Pendant que nous travaillons sur le problème, trouvez-les directement à l'adresse https://build.yunohost.org/
+
 {% if virtualbox or regular %}
 !!! Si votre hôte est en 32 bits, faites bien attention à télécharger l'image 32 bits.
 {% elseif arm_unsup %}
@@ -236,7 +238,7 @@ Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost :
 <div id="cards-list">
 </div>
 </div>
-<script type="text/template" id="image-template">
+<template id="image-template">
 <div id="{id}" class="card panel panel-default">
         <div class="panel-body text-center pt-2">
             <h3>{name}</h3>
@@ -246,14 +248,14 @@ Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost :
             </div>
         </div>
         <div class="annotations flex-container">
-            <div class="flex-child annotation"><a href="{file}.sha256sum">[fa=barcode] Somme de contrôle</a></div>
+            <div class="flex-child annotation"><a href="{file}.sha256sum">[fa=barcode] Checksum</a></div>
             <div class="flex-child annotation"><a href="{file}.sig">[fa=tag] Signature</a></div>
         </div>
         <div class="btn-group" role="group">
             <a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12">[fa=download] Télécharger <small>{version}</small></a>
         </div>
 </div>
-</script>
+</template>
 <script>
 var hardware = "{{ hardware|escape('js') }}";
 /*
@@ -272,13 +274,13 @@ $(document).ready(function () {
              .replace('{id}', infos.id)
              .replace('{name}', infos.name)
              .replace('{comment}', infos.comment || "&nbsp;")
+             .replace('%7Bimage%7D', infos.image)
              .replace('{image}', infos.image)
              .replace('{version}', infos.version);
  
-            if (infos.file.startsWith("http"))
+            if (!infos.file.startsWith("http"))
-                html = html.replace(/{file}/g, infos.file);
+                infos.file="https://build.yunohost.org/"+infos.file;
-            else
+            html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
-                html = html.replace(/{file}/g, "https://build.yunohost.org/"+infos.file);
    
             if ((typeof(infos.has_sig_and_sums) !== 'undefined') && infos.has_sig_and_sums == false)
             {
@@ -563,7 +565,10 @@ Allez dans `Utilisateurs > Nouvel utilisateur`.
 ```
 yunohost user create johndoe
 ```
-TODO : copypasta an actual shell session will all info asked etc..
+
+[figure class="nomargin" caption="Aperçu de l'interface de création utilisateur en ligne de commande"]
+![Création d'un utilisateur en ligne de commande](image://create-first-user-cli.png?resize=100%&class=inline)
+[/figure]
 
 [/ui-tab]
 [/ui-tabs]
@@ -610,7 +615,7 @@ Pour plus d'instructions détaillées, ou pour en savoir plus à propos des cert
 [/ui-tab]
 [ui-tab title="À partir de la ligne de commande"]
 ```
-yunohost domain cert-install
+yunohost domain cert install
 ```
 [/ui-tab]
 [/ui-tabs]

pages/02.administer/10.install/install.it.md

@@ -215,6 +215,8 @@ Here are some VPS providers supporting YunoHost natively :
 {% if at_home %}
 ## [fa=download /] Download the {{image_type}} image
 
+! I link alle immagini sono attualmente interrotti. Mentre stiamo lavorando al problema, potete trovarli direttamente su https://build.yunohost.org/
+
 {% if virtualbox or regular %}
 !!! If your host OS is 32 bits, be sure to download the 32-bit image.
 {% elseif arm_unsup %}
@@ -228,7 +230,7 @@ Here are some VPS providers supporting YunoHost natively :
 <div id="cards-list">
 </div>
 </div>
-<script type="text/template" id="image-template">
+<template id="image-template">
 <div id="{id}" class="card panel panel-default">
         <div class="panel-body text-center pt-2">
             <h3>{name}</h3>
@@ -245,7 +247,7 @@ Here are some VPS providers supporting YunoHost natively :
             <a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12">[fa=download] Download <small>{version}</small></a>
         </div>
 </div>
-</script>
+</template>
 <script>
 var hardware = "{{ hardware|escape('js') }}";
 /*
@@ -264,13 +266,13 @@ $(document).ready(function () {
              .replace('{id}', infos.id)
              .replace('{name}', infos.name)
              .replace('{comment}', infos.comment || "&nbsp;")
+             .replace('%7Bimage%7D', infos.image)
              .replace('{image}', infos.image)
              .replace('{version}', infos.version);
  
-            if (infos.file.startsWith("http"))
+            if (!infos.file.startsWith("http"))
-                html = html.replace(/{file}/g, infos.file);
+                infos.file="https://build.yunohost.org/"+infos.file;
-            else
+            html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
-                html = html.replace(/{file}/g, "https://build.yunohost.org/"+infos.file);
    
             if ((typeof(infos.has_sig_and_sums) !== 'undefined') && infos.has_sig_and_sums == false)
             {
@@ -556,7 +558,10 @@ Go in Users > Add
 ```
 yunohost user create johndoe
 ```
-TODO : copypasta an actual shell session will all info asked etc..
+
+[figure class="nomargin" caption="Anteprima dell'interfaccia utente di creazione dell'utente CLI"]
+![creazione dell'utente CLI](image://create-first-user-cli.png?resize=100%&class=inline)
+[/figure]
 
 [/ui-tab]
 [/ui-tabs]
@@ -603,7 +608,7 @@ For more detailled instructions, or to lean more about SSL/TLS certificates, see
 [/ui-tab]
 [ui-tab title="From the command line"]
 ```
-yunohost domain cert-install
+yunohost domain cert install
 ```
 [/ui-tab]
 [/ui-tabs]

pages/02.administer/10.install/install.md

@@ -29,7 +29,7 @@ routes:
     - '/hardware'
 ---
 {% set image_type = 'YunoHost' %}
-{% set arm, at_home, regular, rpi2plus, rpi1, rpi0, arm_sup, arm_unsup, vps, vps_debian, vps_ynh, virtualbox, internetcube, docker = false, false, false, false, false, false, false, false, false, false, false, false, false, false %}
+{% set arm, at_home, regular, rpi2plus, rpi1, rpi0, arm_sup, arm_unsup, vps, vps_debian, vps_ynh, virtualbox, wsl, internetcube, docker = false, false, false, false, false, false, false, false, false, false, false, false, false, false, false %}
 {% set hardware = uri.param('hardware')  %}
 
 {% if hardware == 'regular' %}
@@ -56,6 +56,8 @@ routes:
   {% set at_home, virtualbox = true, true %}
 {% elseif hardware == 'docker' %}
   {% set docker = true %}
+{% elseif hardware == 'wsl' %}
+  {% set wsl = true %}
 {% endif %}
 
 {% if arm or regular %}
@@ -81,6 +83,10 @@ Select the hardware on which you want install YunoHost :
 [[figure caption="Regular computer"]![](image://computer.png?height=75)[/figure]](/install/hardware:regular)
 [/div]
 
+[div class="flex-child hardware{%if wsl %} active{% endif %}"]
+[[figure caption="WSL"]![](image://wsl.png?height=75)[/figure]](/install/hardware:wsl)
+[/div]
+
 [div class="flex-child hardware{%if vps_debian or vps_ynh %} active{% endif %}"]
 [[figure caption="Remote server"]![](image://vps.png?height=75)[/figure]](/install/hardware:vps_debian)
 [/div]
@@ -130,6 +136,10 @@ Select the hardware on which you want install YunoHost :
 
 {% if hardware != '' %}
 
+{% if wsl %}
+!! This setup is mainly meant for local testing by advanced users. Due to limitations on WSL's side (changing IP address, notably), selfhosting from it can be tricky and will not be described here.
+{% endif %}
+
 {% if docker %}
 !! **YunoHost doesn’t support Docker officially since issues with versions 2.4+. In question, YunoHost 2.4+ doesn’t work anymore on Docker because YunoHost requires systemd and Docker has chosen to not support it natively (and there are other problems link to the firewall and services).**
 !!
@@ -178,6 +188,12 @@ However, community images exist and are available on Docker Hub:
 {% if regular %}
 * A USB stick with at least 1GB capacity OR a standard blank CD
 {% endif %}
+{% if wsl %}
+* Windows 10 and above
+* Administration rights
+* Windows Subsystem for Linux, installed from the Optional Features menu of Windows
+* *Recommended:* Windows Terminal (Preview) app, installed from the Microsoft Store. Much better than the standard Terminal, as it offers shortcuts to the WSL distros.
+{% endif %}
 {% if at_home %}
 * A [reasonable ISP](/isp), preferably with a good and unlimited upstream bandwidth
 {% if rpi0 %}
@@ -195,8 +211,125 @@ However, community images exist and are available on Docker Hub:
 ! N.B. : Installing YunoHost in a VirtualBox is usually intended for testing. To run an actual server on the long-term, you usually need a dedicated physical machine (old computer, ARM board...) or a server online.
 {% endif %}
 
+{% if wsl %}
+## Introduction
+WSL is a nice feature of Windows 10, making Linux pseudo-distributions available through command line. Let's say pseudo, because even though they are not really like virtual machines, they rely on virtualization capacities that make their integration with Windows almost seamless.
+Docker for Windows can now rely on WSL instead of Hyper-V, for example.
 
+! Bear in mind, this setup itself is *not* a container of any kind. If something breaks, there is no rollback capability.
+! You may need to delete the Debian distro altogether and restore it whole.
 
+## Install Debian 11
+
+Let's install YunoHost into its own distro, not altering the default one. In a PowerShell terminal:
+
+```bash
+# Let's go in your home directory and prepare the working directories
+cd ~
+mkdir -p WSL\YunoHost
+# Download the Debian appx package and unzip it
+curl.exe -L -o debian.zip https://aka.ms/wsl-debian-gnulinux
+Expand-Archive .\debian.zip -DestinationPath .\debian
+# Import the Debian base into a new distro
+wsl --import YunoHost ~\WSL\YunoHost ~\debian\install.tar.gz --version 2
+# Cleanup
+rmdir .\debian -R
+```
+
+You can now access it: run `wsl.exe -d YunoHost`
+
+It is under Debian 9 Stretch, so let's upgrade it: 
+
+```bash
+# In WSL
+sudo sed -i 's/stretch/bullseye/g' /etc/apt/sources.list`
+sudo apt update
+sudo apt upgrade
+sudo apt dist-upgrade
+```
+## Prevent WSL from tweaking configuration files
+
+Edit `/etc/wsl.conf` and put the following code in it:
+
+```
+[network]
+generateHosts = false
+generateResolvConf = false
+```
+
+## Force the use of iptables-legacy
+
+Somehow the YunoHost post-installation does not like `nf_tables`, the new software replacing `iptables`.
+We can still explicitely use the good ol' `iptables` though:
+
+```bash
+# In WSL
+sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
+sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy
+```
+
+## Install Systemd
+
+Debian on WSL does not have `systemd`, a service configuration software.
+This is a key element for YunoHost, and for any decent Debian distro (seriously MS, what the heck). Let's install it:
+
+1. Install dotNET runtime:
+```bash
+# In WSL
+wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
+sudo dpkg -i packages-microsoft-prod.deb
+sudo apt update
+sudo apt install -y apt-transport-https
+sudo apt update
+sudo apt install -y dotnet-sdk-3.1
+```
+
+2. Install [Genie](https://github.com/arkane-systems/genie):
+```bash
+# In WSL
+# Add their repository
+echo "deb [trusted=yes] https://wsl-translinux.arkane-systems.net/apt/ /" > /etc/apt/sources.list.d/wsl-translinux.list
+# Install Genie
+sudo apt update
+sudo apt install -y systemd-genie
+```
+
+## Install YunoHost
+
+```bash
+# In WSL
+# Let's switch to the root user, if you were not already
+sudo su
+# Initialize the Genie bottle to have systemd running
+genie -s
+# Your hostname should have been appended with "-wsl"
+# Install YunoHost
+curl https://install.yunohost.org | bash -s -- -a
+```
+
+### Access the command line
+
+Always call `genie -s` while starting your distro.
+
+`wsl -d YunoHost -e genie -s`
+
+## Backup and restore the distro 
+### Make your first distro backup
+As said before, there is no rollback capability. So let's export your fresh distro. In PowerShell:
+
+```
+cd ~
+wsl --export YunoHost .\WSL\YunoHost.tar.gz
+```
+
+### In case of crash, delete and restore the whole distro
+
+```
+cd ~
+wsl --unregister YunoHost
+wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
+```
+{% endif %}
 
 {% if vps_ynh %}
 ## YunoHost VPS providers
@@ -215,6 +348,8 @@ Here are some VPS providers supporting YunoHost natively :
 {% if at_home %}
 ## [fa=download /] Download the {{image_type}} image
 
+! The links to the images are currently broken. While we resolve the issue, you can find them directly on https://build.yunohost.org/
+
 {% if virtualbox or regular %}
 !!! If your host OS is 32 bits, be sure to download the 32-bit image.
 {% elseif arm_unsup %}
@@ -234,7 +369,7 @@ Here are some VPS providers supporting YunoHost natively :
 <div id="cards-list">
 </div>
 </div>
-<script type="text/template" id="image-template">
+<template id="image-template">
 <div id="{id}" class="card panel panel-default">
         <div class="panel-body text-center pt-2">
             <h3>{name}</h3>
@@ -251,7 +386,7 @@ Here are some VPS providers supporting YunoHost natively :
             <a href="{file}" target="_BLANK" type="button" class="btn btn-info col-sm-12">[fa=download] Download <small>{version}</small></a>
         </div>
 </div>
-</script>
+</template>
 <script>
 var hardware = "{{ hardware|escape('js') }}";
 /*
@@ -270,13 +405,13 @@ $(document).ready(function () {
              .replace('{id}', infos.id)
              .replace('{name}', infos.name)
              .replace('{comment}', infos.comment || "&nbsp;")
+             .replace('%7Bimage%7D', infos.image)
              .replace('{image}', infos.image)
              .replace('{version}', infos.version);
  
-            if (infos.file.startsWith("http"))
+            if (!infos.file.startsWith("http"))
-                html = html.replace(/{file}/g, infos.file);
+                infos.file="https://build.yunohost.org/"+infos.file;
-            else
+            html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
-                html = html.replace(/{file}/g, "https://build.yunohost.org/"+infos.file);
    
             if ((typeof(infos.has_sig_and_sums) !== 'undefined') && infos.has_sig_and_sums == false)
             {
@@ -485,11 +620,12 @@ curl https://install.yunohost.org | bash
 
 {% endif %}
 
-
 ## [fa=cog /] Proceed with the initial configuration
 
 !!! If you are in the process of restoring a server using a YunoHost backup, you should skip this step and instead [restore the backup instead of the postinstall step](/backup#restoring-during-the-postinstall).
 
+{% if not wsl %}
+
 [ui-tabs position="top-left" active="0" theme="lite"]
 [ui-tab title="From the web interface"]
 {%if at_home %}
@@ -500,7 +636,9 @@ In an internet browser, type **{% if internetcube %}`https://internetcube.local`
 You can perform the initial configuration with the web interface by typing in the adress bar of your web browser **the public IP address of your server**. Typically, your VPS provider should have provided you with the IP of the server.
 {% endif %}
 
-! During the first visit, you will very likely encounter a security warning related to the certificate used by the server. For now, your server uses a self-signed certificate. You will later be able to add a certificate automatically recognized by web browsers as described in the [certificate documentation](/certificate). For now, you should add a security exception to accept the current certificate. (Though, PLEASE, do not take the habit of blindly accepting this kind of security alert!)
+{% endif %}
+
+! During the first visit, you will very likely encounter a security warning related to the certificate used by the server. For now, your server uses a self-signed certificate. {% if not wsl %}You will later be able to add a certificate automatically recognized by web browsers as described in the [certificate documentation](/certificate). {% endif %} For now, you should add a security exception to accept the current certificate. (Though, PLEASE, do not take the habit of blindly accepting this kind of security alert!)
 
 {% if not internetcube %}
 You should then land on this page :
@@ -528,12 +666,33 @@ You can also perform the postinstallation with the command `yunohost tools posti
 
 This will be the domain used by your server's users to access the **authentication portal**. You can later add other domains, and change which one is the main domain if needed.
 
+{% if not wsl %}
+
 * If you're new to self-hosting and do not already have a domain name, we recommend using a **.nohost.me** / **.noho.st** / **.ynh.fr** (e.g. `homersimpson.nohost.me`). Provided that it's not already taken, the domain will be configured automatically and you won't need any further configuration step. Please note that the downside is that you won't have full-control over the DNS configuration.
 
 * If you already own a domain name, you probably want to use it here. You will later need to configure DNS records as explained [here](/dns_config).
 
 !!! Yes, you *have to* configure a domain name. If you don't have any domain name and don't want a **.nohost.me** / **.noho.st** / **.ynh.fr** either, you can set up a dummy domain such as `yolo.test` and tweak your `/etc/hosts` file such that this dummy domain points to the appropriate IP, as explained [here](/dns_local_network)).
 
+{% else %}
+
+You will have to choose a fake domain, since it will not be accessible from outside.
+For example, `ynh.wsl`. The tricky part is advertising this domain to your host.
+
+Alter your `C:\Windows\System32\drivers\etc\hosts` file. You should have a line starting by `::1`, update it or add it if needed to get:
+
+```
+::1    ynh.wsl localhost
+```
+
+If you want to create subdomains, do not forget to add them in the `hosts` file too:
+
+```
+::1    ynh.wsl subdomain.ynh.wsl localhost
+```
+
+{% endif %}
+
 ##### [fa=key /] Administration password
 
 This password will be used to access to your server's administration interface. You will also use it to connect [via **SSH**](/ssh) or [**SFTP**](/filezilla). In general terms, this is your **system's key**, choose it carefully!
@@ -562,7 +721,10 @@ Go in Users > Click on "+ New User" button
 ```
 yunohost user create johndoe
 ```
-TODO : copypasta an actual shell session will all info asked etc..
+
+[figure class="nomargin" caption="Preview of the user creation CLI"]
+![User creation CLI](image://create-first-user-cli.png?resize=100%&class=inline)
+[/figure]
 
 [/ui-tab]
 [/ui-tabs]
@@ -570,6 +732,10 @@ TODO : copypasta an actual shell session will all info asked etc..
 
 ## [fa=stethoscope /] Run the initial diagnosis
 
+{% if wsl %}
+! Reminder: YunoHost in WSL will likely not be reachable from outside, and real domains and certificates won't be able to be assigned to it.
+{% endif %}
+
 The diagnosis system is meant to provide an easy way to validate that all critical aspects of your server are properly configured - and guide you in how to fix issues. The diagnosis will run twice a day and send an alert if issues are detected.
 
 !!! N.B. : **don't run away** ! The first time you run the diagnosis, it is quite expected to see a bunch of yellow/red alerts because you typically need to [configure DNS records](/dns_config) (if not using a `.nohost.me`/`noho.st`/`ynh.fr` domain), add a swapfile if not enough ram {% if at_home %} and/or [port forwarding](/isp_box_config){% endif %}.
@@ -611,7 +777,7 @@ Go in Domains > Click on your domain > SSL Certificate
 [/ui-tab]
 [ui-tab title="From the command line"]
 ```
-yunohost domain cert-install
+yunohost domain cert install
 ```
 [/ui-tab]
 [/ui-tabs]

pages/02.administer/15.admin_guide/55.upgrade/15.buster_bullseye/buster_bullseye_migration.fr.md

@@ -50,7 +50,7 @@ Si la migration a échoué a un moment donné, la première chose à faire est d
 #### Exécuter la migration pour réparer votre application python
 Après la mise à jour, vos applications python devraient être indisponibles car leur environnement virtuel doit être reconstruit.
 
-Pour ce faire, vous pouvez exécuter les migrations en cours dans `Webadmin > Mises à jour`. Les applications ci-dessous ne seront pas réparées automatiquement, vous devez les mettre à jour manuellement avec `yunohost app upgrade -f APP`.
+Pour ce faire, vous pouvez exécuter les migrations en cours dans `Webadmin > Mises à jour`. Les applications ci-dessous ne seront pas réparées automatiquement, vous devez les mettre à jour manuellement avec `yunohost app upgrade -F APP`.
 
 Les applications qui ne seront pas réparées automatiquement et nécessitent une mise à jour forcée :
  * calibreweb
@@ -82,10 +82,12 @@ Pour cela, vous pouvez aller dans la partie Diagnostic (section Système de base
 Vérifiez que vos applications installées fonctionnent... Si elles ne fonctionnent pas, il est recommandé de tenter de les mettre à jour. (ou bien de manière générale, il est recommandé de les mettre à jour même si elles fonctionnent !).
 
 
-Si votre app est cassée et que vous étiez déjà sur la dernière version d'une application, vous pouvez relancer la mise à jour grâce à l'option `-f`:
+Si votre app est cassée et que vous étiez déjà sur la dernière version d'une application, vous pouvez relancer la mise à jour grâce à l'option `--force`:
 ```
 yunohost app upgrade --force NOM_APP
 ```
 
 ## Soucis (mineurs) connus après la migration
 
+Voir la [page anglaise](https://yunohost.org/en/buster_bullseye_migration#current-known-minor-issues-after-the-migration)
+

pages/02.administer/15.admin_guide/55.upgrade/15.buster_bullseye/buster_bullseye_migration.md

@@ -17,6 +17,8 @@ This page is dedicated to help you migrating an instance from YunoHost 4.4.x (ru
 
 - Please don't rush into thinking that you should need to reinstall your system from scratch thinking it would be "simpler" (sigh). (A common attitude is to be willing to reinstall a server at the slightest complication...) Instead, if you happen to run into issues, we encourage you to try to investigate and understand what's going on and [reach for help on the chat and the forum](/help).
 
+- **You should watch the known issues at the bottom of this page, to be sure your migrations will work properly.**
+
 ## Migration procedure
 
 #### From the webadmin
@@ -28,7 +30,7 @@ After upgrading to 4.4.x, go to Tools > Migrations to access the migrations inte
 After upgrading to 4.4.x, run : 
 
 ```bash
-sudo yunohost tools migrations migrate
+sudo yunohost tools migrations run
 ```
 
 then read carefully and accept the disclaimer.
@@ -54,7 +56,7 @@ For this, go in Diagnosis (category Base system) or look at the footer of the we
 #### Run the migration to repair your python app
 After upgrading, your python apps should be unavailable cause their virtual env need to be rebuild.
 
-To do that you can run the pending migrations in `Webadmin > Update`. The apps below won't be automatically repaired, you need to force upgrade them manually instead with `yunohost app upgrade -f APP`.
+To do that you can run the pending migrations in `Webadmin > Update`. The apps below won't be automatically repaired, you need to force upgrade them manually instead with `yunohost app upgrade -F APP`.
 
 Apps which won't be automatically repaired and need a force upgrade:
  * calibreweb
@@ -83,10 +85,40 @@ If the service php7.3-fpm appears to be dead, you should upgrade your PHP apps l
 
 Test that your applications are working. If they aren't, you should try to upgrade them (it is also a good idea to upgrade them even if they are working anyway).
 
-If your app is broken and you were already with the last version, you can rerun the upgrade thanks to the `-f` option:
+If your app is broken and you were already with the last version, you can rerun the upgrade thanks to the `-F` option:
 ```
 yunohost app upgrade --force APP_NAME
 ```
 
-## Current known (minor) issues after the migration
+## Current known issues after the migration
+
+### Can't run the migration due to `libc6-dev : Breaks: libgcc-8-dev issue`.
+Note: This issue should be resolved in yunohost_version: 4.4.2.13
+You have an app that depends of build-essential package.
+
+See this [solution](https://forum.yunohost.org/t/migration-to-11-wont-start-libc6-dev-breaks-libgcc-8-dev/20617/42) to fix it manually
+
+### DNSmasq is not running anymore
+
+We haven't yet a solution for this issues.
+
+### No ethernet connexion after a reboot after the migration on a rpi 4
+
+! If you have not yet rebooted your server, don't do it we are searching a solution, to avoid the use of a keyboard and screen.
+
+We found this in Rpi documentation
+```
+when the dhcpcd5 package is updated to the latest version (1:8.1.2-1+rpt1 -> 1:8.1.2-1+rpt2), the Raspberry Pi will fail to obtain a DHCP IP address following the next reboot or startup. This problem can be avoided by disabling and re-enabling the "System Options -> Network at Boot" option using the latest raspi-config after the dhcpcd5 package has been updated and prior to the system being shutdown or rebooted
+```
+
+If you are using a rpi 4 (or maybe 3), see this [solution](https://forum.yunohost.org/t/aucun-acces-a-internet-suite-a-migration-4-4-to-11-depuis-raspberry-pi-4-pi-400/20652/17)
+
+### Restore ynh4 backup onto a fresh ynh11
+
+If you can't restore your app but your system has been restored, you probably should use the regen conf to fix the nginx issues:
+```
+yunohost tools regenconf nginx --force
+```
+
+After what you should be able to restore your apps. Don't forget to force upgrade theme if you have 502 errors.
 

pages/02.administer/20.backups/05.evaluate/evaluate.it.md

@@ -0,0 +1,67 @@
+# ---
+title: Strategie di backup
+template: docs
+taxonomy:
+    category: docs
+routes:
+  default: '/backup_strategies'
+page-toc:
+  active: true
+  depth: 3
+---
+
+
+In un contesto di self hosting le strategie di backup sono un fattore chiave per sopperire ad eventi inattesi (incendio, corruzione del database, impossibilità di accedere al server, compromissione del server...). La tipologia di backup da adottare dipende dalla importanza dei dati e dei servizi che vogliamo proteggere. Ad esempio, nel contesto di un server di test possiamo evitare un backup integrale (dati e sistema operativo), al contrario, dovremo porre molta più attenzione nel caso di un server in produzione che contenga dati importanti. In questo caso è necessario conservare più copie di backup *in posti diversi*.
+
+## Ottimizzare il backup
+Un buon backuo consiste in almeno **tre copie dei dati** (compreso l'originale), salvate su almeno **due supporti distinti** che si trovano a loro volta **in due luoghi distinti** (sufficientemente lontani tra loro) e con due diversi sistemi di stoccaggio. Se il vostro backup è cifrato **questa regola aurea si applica anche alla password o frase di decifrazione**.
+
+Un buon backup deve anche essere recente, dovrete quindi essere molto precisi e quando possibile **automatizzare il processo**.
+
+Controllate sempre l'integrità del file di backup.
+
+Per ultimo, un buon backup **deve essere facilmente e velocemente accessibile**. Ricorda di documentare il metodo di recupero e di controllare la velocità delle connessioni in download specialmente se la connessione Internet non è simmetrica.
+
+
+!! Esempi di **backup sicuro e facilmente recuperabile**.
+* backup remoto e automatizzato con borg
+* backup automatizzato su unità locale esterna con borg
+* snapshot o immagine (eseguiti prima di ogni aggiornamento)
+* server monitorato con RAID 1 (o una VPS commerciale che può essere su un array)
+* password di decifratura salvata su (tre supporti e due luoghi diversi)
+
+## Alcuni esempi di esecuzione del backup
+
+* [creare un file di backup e salvarlo manualmente (scelta di default per YunoHost)](/backup#manual-backup)
+* [backup automatizzato (scelta consigliata)](/backup#automatic-or-remote-backup)
+* [backup su disco esterno](/external_storage)
+* [creazione di un'immagine o snapshot](/backup/clone_filesystem)
+* [salvataggio dei dati con metodo personalizzato](/backup/custom_backup_methods)
+
+
+## Rischi
+Di seguito un elenco di errori in ordine crescente di pericolosità. L'ordine proposto varia in base alla vostra situazione (tipo di server, complessità dell'installazione, permessi degli utenti), ponete attenzione alla vostra configurazione, avendo ben presenti le conseguenze di una possibile perdita dei dati.
+
+!!! Tenete presente che i rischi reali sono collegati all'evenienza di 2 eventi contemporanei
+
+* **Imprecisione**: i backup manuali richiedono rigore e regolarità
+* **Errata gestione**: cancellazione involontaria di un file di backup in un sistema di sincronizzazione client server di backup, cancellazione che si propaga instantaneamente
+* **Cryptolocker**: si tratta di virus che cifrano i file e chiedono un riscatto. Se i vostri utenti usano nextcloud e windows un sistema windows infetto può sincronizzare file cifrati perdendo così le copie di backup.
+* **Guasto hardware**: le schede SD sono i supporti meno affidabili nel tempo (si stima meno di 2 anni di vita in un server), seguite dai dischi SSD (circa 3 anni di vita) e i dischi HD (3 anni). Ricordate che neppure un'infrastruttura nuova è esente al 100% da guasti nei primi sei mesi di vita. In ogni caso le copie non devono stare sugli stessi supporti fisici.
+* **Bug software**: il malfunzionamento del software può portare alla perdita dei dati oppure potreste non sapere come risolvere un problema e quindi vorrete recuperare il vostro sistema.
+* **Assenza di energia elettrica o connessione**: prevedete un piano di azione se dovesse succedere...quando siete in vacanza.
+* **Catastrofi naturali e non**: un bambino o di un gatto, un fulmine o una perdita di acqua, incendio e inondazioni possono rovinare il vostro backup custodito nella stanza adiacente.
+* **Compromissione del server**: un attacco informatico diretto al vostro server potrebbe cancellarne i dati
+* **Furto**: nel caso di furto potreste perdere il software di gestione della password per decriptare il backup.
+* **Problemi legali**: per poter dimostrare la vostra innocenza i vostri pc potrebbero essere sequestrati, a casa vostra e altrove
+* **Decesso o malattia**: potreste non essere più in grado di digitare la vostra password 
+
+## Qualche info sulla sincronizzazione Nextcloud o Thunderbird (IMAP)
+Un metodo per un parziale backup consiste nello salvare i file e le mail tramite dei programmi di sincronizzazione quali Nextcloud o Thunderbird. In questo modo eviterete le perdite dovute ad un guasto fisico.
+
+La semplicità di tale operazione comporta qualche rischio intrinseco nella natura stessa del metodo, sopratutto se usato in ambiente mac o windows. Un [crytolocker](https://en.wikipedia.org/wiki/Ransomware) sul vostro pc porterebbe come conseguenza la perdita dei file sul server nextcloud, così come una involontaria cancellazione del file sul pc. Normalmente la sincronizzazione tra il pc e il server nextcloud è istantanea e quindi i danni sono irreparabili.
+
+Anche se il rischio di evento del genere può essere attenuato con programmi quali Timeshift, solo il backup su un supporto non connesso vi proteggerà dai crytolocker.
+    
+    
+    

pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.fr.md

@@ -61,7 +61,7 @@ app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ss
 
 Créer les archives tar (une archive par app et partie de système)
 ```
-app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost/archives/ARCHIVE.tar
+app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost.backup/archives/ARCHIVE.tar
 ```
 
 Puis restaurer l'archive de façon classique.

pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.it.md

@@ -0,0 +1,85 @@
+---
+title: BorgBackup
+template: docs
+taxonomy:
+    category: docs
+routes:
+  default: '/backup/borgbackup'
+page-toc:
+  active: true
+  depth: 3
+---
+
+YunoHost propone due programmi per [BorgBackup](https://www.borgbackup.org/).
+
+## Funzionalità
+con BorgBackup potrete:
+* effettuare il backup dei dati in un HD esterno o in un repository borg remoto
+* deduplicare e comprimere i file, che permette di mantenere molte versioni precedenti
+* la cifratura dei dati, permettendo così di conservare in modo sicuro i file presso soggetti terzi
+* definire i tipi di dati da copiare e la frequenza di backup
+* ricevere una mail di allerta in caso di fallimento del backup
+
+Oltre ai [fornitori terzi di repository](https://www.borgbackup.org/support/commercial.html), vi è la possibilità di hostare il proprio repository su una differente installazione yunohost con installata l'[applicazione borgserver](https://github.com/YunoHost-Apps/borgserver_ynh).
+
+Il futuro metodo di backup integrato in YunoHost sarà basato su BorgBackup
+
+## Pianificazione del backup
+
+!!!Installate l'[applicazione borg](https://github.com/YunoHost-Apps/borg_ynh), ed eventualmente l'[applicazione borgserver](https://github.com/YunoHost-Apps/borgserver_ynh).
+
+
+## Test
+Con il programma borg una mail viene inviata nel caso la sessione di backup fallisca o nel caso il repository di destinazione non riceva nessun dato. Da terminale possiamo controllare nei minimi dettagli, che tutto funzioni.
+
+
+```bash
+# Elencare i files
+app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)" | less
+
+# Elencare le esportazioni del database
+app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)" | grep "(db|dump)\.sql"
+
+# Elencare i file contenuti nell'archivio
+app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)::ARCHIVE" | less
+
+# Ottenere informazioni sull'archivio
+app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg info "$(yunohost app setting $app repository)::ARCHIVE"
+
+# Verificare l'integrità dei dati
+app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg check "$(yunohost app setting $app repository)::ARCHIVE" --verify-data
+```
+
+## Ripristino
+
+Se effettuiamo il ripristino dopo una migrazione o una reinstallazione dobbiamo reinstallare borg nello stessa maniera. Se il repository si trova in un server remoto bisogna cambiare la chiave pubblica.
+
+Elencare gli archivi disponibili
+```
+app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)"
+```
+
+Creare gli archivi tar (uno per ogni applicazione e componente del sistema)
+```
+app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost/archives/ARCHIVE.tar
+```
+
+In seguito ripristinare l'archivio come di consueto.
+
+### Ripristino di archivi di grandi dimensioni
+Se lo spazio disponibile è inferiore alla dimensione del vostro archivio, dei dati scompattati e delle dipendenze, dovrete ripristinare un'applicazione alla volta.
+
+Se il ripristino non riesce  o se un archivio è troppo grande, è più prudente creare un archivio tar senza la parte più grande dei dati, cioè come se l'archivio fosse stato creato con l'[opzione BACKUP_CORE_ONLY](/backup/include_exclude_files#don't-save-large-quantities-of-data). Di seguito un esempio con Nextcloud:
+```
+app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar -e apps/nextcloud/backup/home/yunohost.app "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost/archives/ARCHIVE.tar
+```
+
+In seguito si estrarranno questi dati direttamente con borg
+```
+cd /home/yunohost.app/
+app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg extract "$(yunohost app setting $app repository)::ARCHIVE" apps/nextcloud/backup/home/yunohost.app/
+mv apps/nextcloud/backup/home/yunohost.app/nextcloud ./
+rm -r apps
+```
+
+ Procedere poi con il consueto metodo di ripristino 

pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.it.md

@@ -0,0 +1,160 @@
+---
+title: Create a filesystem image
+template: docs
+taxonomy:
+    category: docs
+routes:
+  default: '/backup/clone_filesystem'
+page-toc:
+  active: true
+  depth: 3
+---
+
+!! Images are missing on this page
+
+Lo strumento di backup di Yunohost salva solamente i files utili e si basa su degli script di ripristino per reinstallare le dipendenze dei vostri programmi installati. In altre parole, il ripristino di YunoHost prevede in un primo tempo la reinstallazione del sistema e in seguito il ripristino dei dati.
+
+Realizzare un'immagine completa può essere un metodo, complementare o alternativo, per un backup del vostro server. Il vantaggio sta nel fatto che il vostro server può essere ripristinato nella stessa configurazione presente al momento del backup.
+
+In base a quale tipo di installazione avete, potrete creare uno snapshot oppure clonare il supporto che ospita il sistema (mentre è spento).
+
+## Eseguire uno snapshot
+Lo snapshot permette di congelare l'immagine del file system. Gli snapshot sono molto comodi in caso di aggiornamenti frequenti o di prove, perché vi permettono di tornare facilmente sui vostri passi in caso di problemi. Purtroppo, a meno di non avere un cluster ad altissima affidabilità, gli snapshot non vi proteggono efficacemente contro i guasti hardware o catastrofi (come l'incendio di OVH a Strasburgo nel 2021).
+
+Generalmente gli snapshot non occupano molto spazio sull'hard disk, si basano sul principio del backup differenziale, salvano cioè solo le variazioni dei file avvenute dopo la creazione del primo snapshot. Di conseguenza solo le modifiche prendono spazio.
+
+! Ricordatevi di cancellare i vecchi snapshot, eviterete di consumare inutilmente spazio con backup differenziali troppo datati!
+
+Potete usare questo sistema con la maggior parte dei fornitori VPS (quasi sempre a pagamento), nei programmi di gestione di macchine virtuali oppure, se avete installato YunoHost con un filesystem avanzato quale btrfs, ceph o ZFS potrete creare gli snapshot da riga di comando.
+
+[ui-tabs position="top-left" active="0" theme="lite"]
+[ui-tab title="VPS"]
+Sotto la documentazione per i provider più conosciuti:
+ * [DigitalOcean (EN)](https://docs.digitalocean.com/products/images/snapshots/)
+ * [Gandi](https://docs.gandi.net/fr/simple_hosting/operations_courantes/snapshots.html)
+ * [OVH](https://docs.ovh.com/fr/vps/snapshot-vps/)
+ * [Scaleway (EN)](https://www.scaleway.com/en/docs/backup-your-data-with-snapshots/)
+[/ui-tab]
+[ui-tab title="VirtualBox"]
+Seleziona la macchina virtuale e clicca su `Snapshot`, poi indica il nome dello snapshot e clicca `OK`.
+![Il bottone per gli snapshot button si trova in alto a destra](image://virtualbox-snapshot2.webp)
+
+Per ripristinare, selezionate la macchina virtuale, cliccate su`Snapshots` poi scegliete `Restore Snapshot option`.
+![](image://virtualbox-snapshot3.webp)
+
+Infine cliccate su `Restore Snapshot`.
+![](image://virtualbox-snapshot4.webp)
+[/ui-tab]
+[ui-tab title="Proxmox"]
+
+* Selezionate la macchina virtuale
+* Andate al tab `Backup`
+* Cliccate su `Backup now`
+* Scegliete `Snapshot`
+* Confermate
+[/ui-tab]
+[ui-tab title="BTRFS"]
+Nell'esempio seguente `/pool/volume` è il volume da salvare.
+
+Creare uno snapshot in sola lettura
+```
+btrfs subvolume snapshot /pool/volume /pool/volume/$(date +"%Y-%m-%d_%H:%M")
+```
+
+Elencare gli snapshots
+```
+btrfs subvolume show /pool/volume
+```
+
+Ripristinare uno snapshots
+```
+btrfs sub del /pool/volume
+btrfs sub snap /pool/volume/2021-07-22_16:12 /pool/volume
+btrfs sub del /pool/volume/2021-07-22_16:12
+```
+
+Cancellare uno snapshot
+```
+btrfs subvolume delete /pool/volume/2021-07-22_16:12
+```
+!! Attenzione a non cancellate il volume originale
+
+!!! Seguite [questo tutorial](https://www.linux.com/training-tutorials/how-create-and-manage-btrfs-snapshots-and-rollbacks-linux-part-2/) per maggiori informazioni
+[/ui-tab]
+[ui-tab title="CEPH"]
+Nell'esempio seguente `pool/volume` è il volume che vogliamo salvare
+
+Creare uno snapshots
+```
+rbd snap create pool/volume@$(date +"%Y-%m-%d_%H:%M")
+```
+
+Elencare gli snapshot
+```
+rbd snap ls pool/volume
+```
+
+Ripristinare uno snapshot
+```
+rbd snap rollback pool/volume@2021-07-22_16:22
+```
+
+Cancellare uno snapshot
+```
+rbd snap rm pool/volume@2021-07-22_16:12
+```
+[/ui-tab]
+[ui-tab title="ZFS"]
+Nell'esempio seguente `pool/volume` è il volume che vogliamo salvare.
+
+Creare uno snapshot
+```
+zfs snapshot pool/volume@$(date +"%Y-%m-%d_%H:%M")
+```
+
+Elencare gli snapshots
+```
+zfs list -t snapshot -o name,creation
+```
+Ripristinare uno snapshot
+```
+zfs rollback pool/volume@2021-07-22_16:22
+```
+
+Cancellare uno snapshot
+```
+zfs destroy pool/volume@2021-07-22_16:12
+```
+
+[/ui-tab]
+[/ui-tabs]
+
+
+## Creare una immagine a freddo del server
+
+Potete clonare il supporto del vostro server (scheda SD, disco SSD, volume di un VPS...) al fine di creare una immagine del disco. L'immagine creata, prima che venga compressa, sarà della stessa dimensione del vostro supporto e di conseguenza questa procedura è consigliata per supporti di capacità inferiore a 64GB.
+
+Questo metodo comporta lo spegnimento del server per il tempo necessario alla creazione dell'immagine, eccetto nel caso che possiate usare uno snapshot come origine. Se il server YunoHost è ospitato su un VPS dovrete riavviarlo in modalità rescue dall'interfaccia del vostro provider.
+
+[ui-tabs position="top-left" active="0" theme="lite"]
+[ui-tab title="Usando USBimager"]
+Questo può essere fatto con il programma [USBimager](https://bztsrc.gitlab.io/usbimager/)  <https://bztsrc.gitlab.io/usbimager/> (N.B.: assicuratevi di scaricare la versione  'Read-write'! Non la versione 'Write-only'!). Il processo poi prosegue "all'opposto" della copia sulla scheda SD:
+- Spegnete il vostro server
+- Estraete la scheda SD e inseritela nel pc
+- Nel programma USBimage cliccate su "Read" per creare l'immagine ("photograph") della scheda SD. Il file ottenuto verrà utilizzato per il ripristino del sistema.
+
+Maggiori informazioni [nella documentazione di USBimager](https://gitlab.com/bztsrc/usbimager/#creating-backup-image-file-from-device)
+[/ui-tab]
+[ui-tab title="Usando la linea di comando con dd"]
+
+Se siete avezzi al terminale potete ottenere lo stesso risultato con il comando `dd`
+
+```bash
+dd if=/dev/mmcblk0 | gzip > ./my_snapshot.gz
+```
+
+dove `/dev/mmcblk0` sarà il vostro supporto (scheda SD o disco).
+
+[/ui-tab]
+[/ui-tabs]
+

pages/02.administer/20.backups/25.include_exclude_files/include_exclude_files.fr.md

@@ -110,6 +110,8 @@ Il n'existe pas de mécanisme pour exclure d'une sauvegarde au format YunoHost d
 ### Éviter de sauvegarder certains dossiers du `/home`
 Si besoin, vous pouvez spécifier que certains dossiers `home` d'utilisateurs ou utilisatrices ne soient pas sauvegardés par la commande `yunohost backup`, en créant un fichier vide nommé `.nobackup` à l'intérieur.
 
+Attention ce mécanisme ne fonctionne que pour les **sous-dossiers de premier niveau** du `/home`, comme par exemple `/home/user1` ou `/home/yunohost.multimedia` . Cela ne fonctionne pas pour les autres dossiers ou sous-dossiers, comme par exemple `/home/user1/grosdossier`.
+
 ### Ne pas sauvegarder les grosses quantités de données
 
 Certaines apps comme Nextcloud sont potentiellement rattachées à des quantités importantes de données. Il est possible de ne pas les sauvegarder par défaut. Dans ce cas, on dit que l'app "sauvegarde uniquement le core" (de l'app).  

pages/02.administer/20.backups/25.include_exclude_files/include_exclude_files.md

@@ -113,6 +113,8 @@ There is no mechanism to exclude specific files from a YunoHost backup, other th
 ### Avoid backing up certain `/home` folders
 If needed, you can specify that certain user `home` folders not be backed up by the `yunohost backup` command, by creating an empty file named `.nobackup` inside.
 
+Caution: this setup only works with **first-level subfolders of `/home`**, such as `/home/user1` or `/home/yunohost.multimedia`. It does not work for other levels of subfolders, like `/home/user1/bigfolder/`.
+
 ### Do not backup large amounts of data
 
 Some apps like Nextcloud are potentially attached to large amounts of data. It is possible to not backup them by default. In this case, the app is said to "backup only the core" (of the app).  

pages/04.applications/10.docs/20euros/app_20euros.fr.md

@@ -0,0 +1,22 @@
+---
+title: 20 euros
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_20euros'
+---
+
+[![Installer 20 euros avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=20euros) [![Integration level](https://dash.yunohost.org/integration/20euros.svg)](https://dash.yunohost.org/appci/app/20euros)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*20 euros* est une variante de 2048 avec des pièces et des billets en euros.
+
+## Liens utiles
+
++ Site web : [github.com/jatekos101/20euros](https://github.com/jatekos101/20euros)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/20euros](https://github.com/YunoHost-Apps/20euros_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/20euros/issues](https://github.com/YunoHost-Apps/20euros_ynh/issues)

pages/04.applications/10.docs/20euros/app_20euros.md

@@ -0,0 +1,22 @@
+---
+title: 20 euros
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_20euros'
+---
+
+[![Install 20 euros with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=20euros) [![Integration level](https://dash.yunohost.org/integration/20euros.svg)](https://dash.yunohost.org/appci/app/20euros)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*20 euros* is a 2048 variant with Euro coins and notes.
+
+## Useful links
+
++ Website: [github.com/jatekos101/20euros](https://github.com/jatekos101/20euros)
++ Application software repository: [github.com - YunoHost-Apps/20euros](https://github.com/YunoHost-Apps/20euros_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/20euros/issues](https://github.com/YunoHost-Apps/20euros_ynh/issues)

pages/04.applications/10.docs/243/app_243.fr.md

@@ -0,0 +1,23 @@
+---
+title: 243
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_243'
+---
+
+[![Installer 243 avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=243) [![Integration level](https://dash.yunohost.org/integration/243.svg)](https://dash.yunohost.org/appci/app/243)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*243* est un clone du jeu 2048.
+
+## Liens utiles
+
++ Site web : [github.com/hgentry/81/](https://github.com/hgentry/81/)
++ Demonstration: [Demo](https://hgentry.github.io/81/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/243](https://github.com/YunoHost-Apps/243_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/243/issues](https://github.com/YunoHost-Apps/243_ynh/issues)

pages/04.applications/10.docs/243/app_243.md

@@ -0,0 +1,23 @@
+---
+title: 243
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_243'
+---
+
+[![Install 243 with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=243) [![Integration level](https://dash.yunohost.org/integration/243.svg)](https://dash.yunohost.org/appci/app/243)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*243* is a 2048 game clone.
+
+## Useful links
+
++ Website: [github.com/hgentry/81/](https://github.com/hgentry/81/)
++ Demonstration: [Demo](https://hgentry.github.io/81/)
++ Application software repository: [github.com - YunoHost-Apps/243](https://github.com/YunoHost-Apps/243_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/243/issues](https://github.com/YunoHost-Apps/243_ynh/issues)

pages/04.applications/10.docs/aeneria/app_aeneria.fr.md

@@ -0,0 +1,23 @@
+---
+title: Æneria
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_aeneria'
+---
+
+[![Installer Æneria avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=aeneria) [![Integration level](https://dash.yunohost.org/integration/aeneria.svg)](https://dash.yunohost.org/appci/app/aeneria)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Æneria* est une application web dont le but est d'aider les particuliers à analyser leur consommation d'énergie. Parce que comprendre sa consommation, c'est déjà, sans s'en rendre compte, commencer à la réduire.
+
+## Liens utiles
+
++ Site web : [aeneria.com (fr)](https://aeneria.com/)
++ Démonstration : [Démo](https://demo.aeneria.com/login)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/aeneria](https://github.com/YunoHost-Apps/aeneria_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/aeneria/issues](https://github.com/YunoHost-Apps/aeneria_ynh/issues)

pages/04.applications/10.docs/aeneria/app_aeneria.md

@@ -0,0 +1,23 @@
+---
+title: Æneria
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_aeneria'
+---
+
+[![Install Æneria with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=aeneria) [![Integration level](https://dash.yunohost.org/integration/aeneria.svg)](https://dash.yunohost.org/appci/app/aeneria)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Æneria* is a web application which aims to help individuals to analyse their energy consumption. Because understanding one's consumption is already, without realising it, starting to reduce it.
+
+## Useful links
+
++ Website: [aeneria.com (fr)](https://aeneria.com/)
++ Demonstration: [Demo](https://demo.aeneria.com/login)
++ Application software repository: [github.com - YunoHost-Apps/aeneria](https://github.com/YunoHost-Apps/aeneria_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/aeneria/issues](https://github.com/YunoHost-Apps/aeneria_ynh/issues)

pages/04.applications/10.docs/agendav/app_agendav.fr.md

@@ -0,0 +1,23 @@
+---
+title: AgenDAV
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_agendav'
+---
+
+[![Installer AgenDAV avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=agendav) [![Integration level](https://dash.yunohost.org/integration/agendav.svg)](https://dash.yunohost.org/appci/app/agendav)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*AgenDAV* est un client web CalDAV qui présente une interface AJAX permettant aux utilisateurs de gérer leurs propres calendriers et les calendriers partagés.
+
+## Liens utiles
+
++ Site web : [agendav.org](https://agendav.org/)
++ Démonstration : [Démo](https://demo.yunohost.org/agendav/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/agendav](https://github.com/YunoHost-Apps/agendav_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/agendav/issues](https://github.com/YunoHost-Apps/agendav_ynh/issues)

pages/04.applications/10.docs/agendav/app_agendav.md

@@ -0,0 +1,23 @@
+---
+title: AgenDAV
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_agendav'
+---
+
+[![Install AgenDAV with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=agendav) [![Integration level](https://dash.yunohost.org/integration/agendav.svg)](https://dash.yunohost.org/appci/app/agendav)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*AgenDAV* is a CalDAV web client which features an AJAX interface to allow users to manage their own calendars and shared ones.
+
+## Useful links
+
++ Website: [agendav.org](https://agendav.org/)
++ Demonstration: [Demo](https://demo.yunohost.org/agendav/)
++ Application software repository: [github.com - YunoHost-Apps/agendav](https://github.com/YunoHost-Apps/agendav_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/agendav/issues](https://github.com/YunoHost-Apps/agendav_ynh/issues)

pages/04.applications/10.docs/alltube/app_alltube.fr.md

@@ -0,0 +1,24 @@
+---
+title: AllTube
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_alltube'
+---
+
+[![Installer AllTube avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=alltube) [![Integration level](https://dash.yunohost.org/integration/alltube.svg)](https://dash.yunohost.org/appci/app/alltube)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*AllTube* est une interface web pour Youtube-dl.
+Pour configurer AllTube : éditez le fichier `/var/www/alltube/config/config.yml` via SSH.
+
+## Liens utiles
+
++ Site web : [alltubedownload.net](https://alltubedownload.net/)
++ Démonstration : [Démo](https://alltubedownload.net/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/alltube](https://github.com/YunoHost-Apps/alltube_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/alltube/issues](https://github.com/YunoHost-Apps/alltube_ynh/issues)

pages/04.applications/10.docs/alltube/app_alltube.md

@@ -0,0 +1,24 @@
+---
+title: AllTube
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_alltube'
+---
+
+[![Install AllTube with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=alltube) [![Integration level](https://dash.yunohost.org/integration/alltube.svg)](https://dash.yunohost.org/appci/app/alltube)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*AllTube* is a web interface for Youtube-dl.
+To configure AllTube: edit the file `/var/www/alltube/config/config.yml` via SSH.
+
+## Useful links
+
++ Website: [alltubedownload.net](https://alltubedownload.net/)
++ Demonstration: [Demo](https://alltubedownload.net/)
++ Application software repository: [github.com - YunoHost-Apps/alltube](https://github.com/YunoHost-Apps/alltube_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/alltube/issues](https://github.com/YunoHost-Apps/alltube_ynh/issues)

pages/04.applications/10.docs/backdrop/app_backdrop.fr.md

@@ -0,0 +1,23 @@
+---
+title: Backdrop
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_backdrop'
+---
+
+[![Installer Backdrop avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=backdrop) [![Integration level](https://dash.yunohost.org/integration/backdrop.svg)](https://dash.yunohost.org/appci/app/backdrop)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Backdrop* est un système de gestion de contenu complet qui permet aux utilisateurs non techniques de gérer une grande variété de contenus. Il peut être utilisé pour créer toutes sortes de sites web, notamment des blogs, des galeries d'images, des réseaux sociaux, des intranets, etc.
+
+## Liens utiles
+
++ Site web : [backdropcms.org](https://backdropcms.org/)
++ Démonstration : [Démo](https://backdropcms.org/demo)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/backdrop](https://github.com/YunoHost-Apps/backdrop_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/backdrop/issues](https://github.com/YunoHost-Apps/backdrop_ynh/issues)

pages/04.applications/10.docs/backdrop/app_backdrop.md

@@ -0,0 +1,23 @@
+---
+title: Backdrop
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_backdrop'
+---
+
+[![Install Backdrop with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=backdrop) [![Integration level](https://dash.yunohost.org/integration/backdrop.svg)](https://dash.yunohost.org/appci/app/backdrop)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Backdrop* is a full-featured content management system that allows non-technical users to manage a wide variety of content. It can be used to create all kinds of websites including blogs, image galleries, social networks, intranets, and more.
+
+## Useful links
+
++ Website: [backdropcms.org](https://backdropcms.org/)
++ Demonstration: [Demo](https://backdropcms.org/demo)
++ Application software repository: [github.com - YunoHost-Apps/backdrop](https://github.com/YunoHost-Apps/backdrop_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/backdrop/issues](https://github.com/YunoHost-Apps/backdrop_ynh/issues)

pages/04.applications/10.docs/bicbucstriim/app_bicbucstriim.fr.md

@@ -0,0 +1,32 @@
+---
+title: BicBucStriim
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_bicbucstriim'
+---
+
+[![Installer BicBucStriim avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=bicbucstriim) [![Integration level](https://dash.yunohost.org/integration/bicbucstriim.svg)](https://dash.yunohost.org/appci/app/bicbucstriim)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*BicBucStriim* diffuse des livres, des livres numériques. Il a été conçu principalement pour combler une lacune dans la fonctionnalité des appareils NAS qui donnent accès à la musique, aux vidéos et aux photos -- mais pas aux livres. BicBucStriim comble cette lacune et fournit un accès basé sur le web à votre collection de livres électroniques.
+
+## Avertissements / informations importantes 
+
+BicBucStriim est une simple application PHP qui fonctionne dans l'environnement Apache/PHP fourni par le NAS (ou tout autre serveur). Elle suppose que vous gérez votre collection d'e-books avec Calibre. L'application lit les données Calibre et les publie sous forme HTML. Pour accéder au catalogue d'e-books, il vous suffit de diriger votre lecteur d'e-books vers votre NAS, de sélectionner l'un de vos e-books et de le télécharger.
+
+## Configuration
+
+BicBucStriim fraîchement installée affichera une page de connexion. Les informations de connexion initiales pour l'administrateur sont
+    nom d'utilisateur : admin
+    mot de passe : admin
+
+## Liens utiles
+
++ Site web : [projekte.textmulch.de/bicbucstriim/](http://projekte.textmulch.de/bicbucstriim/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/bicbucstriim](https://github.com/YunoHost-Apps/bicbucstriim_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/bicbucstriim/issues](https://github.com/YunoHost-Apps/bicbucstriim_ynh/issues)

pages/04.applications/10.docs/bicbucstriim/app_bicbucstriim.md

@@ -0,0 +1,32 @@
+---
+title: BicBucStriim
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_bicbucstriim'
+---
+
+[![Install BicBucStriim with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=bicbucstriim) [![Integration level](https://dash.yunohost.org/integration/bicbucstriim.svg)](https://dash.yunohost.org/appci/app/bicbucstriim)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*BicBucStriim* streams books, digital books. It was primarily designed to fill a gap in the functionality of NAS devices that provide access to music, videos and photos -- but not books. BicBucStriim fills this gap and provides web-based access to your e-book collection.
+
+## Disclaimers / important information
+
+BicBucStriim is a simple PHP application that runs in the Apache/PHP environment provided by the NAS (or any other server). It assumes that you manage your e-book collection with Calibre. The application reads the Calibre data and publishes it in HTML form. To access the e-book catalog you simply point your ebook reader to your NAS, select one of your e-books and download it.
+
+## Configuration
+
+A freshly installed BicBucStriim installation will show the login page. The initial login information for the administrator is
+    user name: admin
+    password : admin
+
+## Useful links
+
++ Website: [projekte.textmulch.de/bicbucstriim/](http://projekte.textmulch.de/bicbucstriim/)
++ Application software repository: [github.com - YunoHost-Apps/bicbucstriim](https://github.com/YunoHost-Apps/bicbucstriim_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/bicbucstriim/issues](https://github.com/YunoHost-Apps/bicbucstriim_ynh/issues)

pages/04.applications/10.docs/castopod/app_castopod.fr.md

@@ -0,0 +1,29 @@
+---
+title: Castopod
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_castopod'
+---
+
+[![Installer Castopod avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=castopod) [![Integration level](https://dash.yunohost.org/integration/castopod.svg)](https://dash.yunohost.org/appci/app/castopod)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Castopod* est une plateforme d'hébergement gratuite et open-source conçue pour les podcasteurs qui souhaitent s'engager et interagir avec leur public.
+
+Castopod est facile à installer et a été construit sur la base de CodeIgniter4, un puissant framework PHP à l'empreinte très réduite.
+
+# Statut
+
+Castopod est actuellement en version bêta mais déjà très stable et utilisé par des podcasteurs du monde entier !
+
+## Liens utiles
+
++ Site web : [castopod.org](https://castopod.org/)
++ Démonstration : [Démo](https://podcast.podlibre.org/@podlibre_fr)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/castopod](https://github.com/YunoHost-Apps/castopod_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/castopod/issues](https://github.com/YunoHost-Apps/castopod_ynh/issues)

pages/04.applications/10.docs/castopod/app_castopod.md

@@ -0,0 +1,29 @@
+---
+title: Castopod
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_castopod'
+---
+
+[![Install Castopod with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=castopod) [![Integration level](https://dash.yunohost.org/integration/castopod.svg)](https://dash.yunohost.org/appci/app/castopod)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Castopod* is a free & open-source hosting platform made for podcasters who want engage and interact with their audience.
+
+Castopod is easy to install and was built on top of CodeIgniter4, a powerful PHP framework with a very small footprint.
+
+# Status
+
+Castopod is currently in beta but already quite stable and used by podcasters around the world!
+
+## Useful links
+
++ Website: [castopod.org](https://castopod.org/)
++ Demonstration: [Demo](https://podcast.podlibre.org/@podlibre_en)
++ Application software repository: [github.com - YunoHost-Apps/castopod](https://github.com/YunoHost-Apps/castopod_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/castopod/issues](https://github.com/YunoHost-Apps/castopod_ynh/issues)

pages/04.applications/10.docs/cinny/app_cinny.fr.md

@@ -0,0 +1,30 @@
+---
+title: Cinny
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_cinny'
+---
+
+[![Installer Cinny avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=cinny) [![Integration level](https://dash.yunohost.org/integration/cinny.svg)](https://dash.yunohost.org/appci/app/cinny)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Cinny* est une plateforme d'hébergement gratuite et open-source conçue pour les podcasteurs qui souhaitent s'engager et interagir avec leur public.
+
+Cinny est facile à installer et a été construit sur la base de CodeIgniter4, un puissant framework PHP à l'empreinte très réduite.
+
+## Avertissements / informations importantes
+
+Il n'y a pas de support LDAP (et il n'y en aura jamais).
+Cinny n'est qu'un client, vous devez déjà avoir un compte sur un serveur (voir l'application YunoHost de Synapse).
+
+## Liens utiles
+
++ Site web : [cinny.in](https://cinny.in/)
++ Démonstration : [Démo](https://app.cinny.in/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/cinny](https://github.com/YunoHost-Apps/cinny_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/cinny/issues](https://github.com/YunoHost-Apps/cinny_ynh/issues)

pages/04.applications/10.docs/cinny/app_cinny.md

@@ -0,0 +1,28 @@
+---
+title: Cinny
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_cinny'
+---
+
+[![Install Cinny with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=cinny) [![Integration level](https://dash.yunohost.org/integration/cinny.svg)](https://dash.yunohost.org/appci/app/cinny)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Cinny* A Matrix client focusing primarily on simple, elegant and secure interface.
+
+## Disclaimers / important information
+
+There's no LDAP support (and never will be).
+Cinny only is a client, you need to have an account on a server already (see the Synapse YunoHost app)
+
+## Useful links
+
++ Website: [cinny.in](https://cinny.in/)
++ Demonstration: [Demo](https://app.cinny.in/)
++ Application software repository: [github.com - YunoHost-Apps/cinny](https://github.com/YunoHost-Apps/cinny_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/cinny/issues](https://github.com/YunoHost-Apps/cinny_ynh/issues)

pages/04.applications/10.docs/collabora/app_collabora.fr.md

@@ -17,6 +17,50 @@ routes:
 
 Collabora est une suite bureautique en ligne basée sur LibreOffice et utilisable avec Nextcloud ou ownCloud. Elle permet d'éditer des documents textes, des tableaux, des diaporamas. L'édition en ligne peut se faire en simultanée et permet d'exporter et d'imprimer des documents grâce au format PDF généré.
 
+Cette application n'est pas compatible avec les architectures ARM. Le projet Collabora a bien développé une version spécifique ARM, mais celle-ci n'est compatible qu'avec Ubuntu, pas Debian, donc ne fonctionne pas sous YunoHost.
+
+### Architectures ARM
+
+Il existe une solution pour faire tourner Collabora Online Document Server sur des architectures ARM (Raspberry Pi...), via Nextcloud.
+
+#### 1. Télécharger et activer le Collabora Online Document Server
+
+#### Attention : cette étape doit être réalisée depuis un terminal, et non depuis l'interface graphique de Nextcloud
+
+Dans un terminal, se placer en super user
+
+```bash
+sudo su
+```
+
+puis lancer la commande d'installation du CODE :
+
+```bash
+sudo -u nextcloud php --define apc.enable_cli=1 -d memory_limit=512M /var/www/nextcloud/occ app:install richdocumentscode_arm64
+```
+
+#### 2. Corriger la configuration de NGINX pour Nextcloud
+
+Pour que le CODE soit connecté à Nextcloud, le proxy doit faire le lien entre CODE (richdocumentscode_arm64) et Nextcloud.
+Or le fichier config par défaut de NGINX pour Nextcloud fait référence à richdocumentscode au lieu de rich documentscode_arm64, qui est le nom de l'application dans notre cas des architectures ARM.
+
+Il faut donc faire :
+
+```bash
+cd /etc/nginx/conf.d/[nextcloud.votredomaine.com].d
+```
+
+```bash
+sudo nano nextcloud.conf
+```
+Dans le fichier, repérer la ligne comportant "richdocumentscode", puis ajouter "_arm64" juste après, enregistrer (Ctrl+S) et sortir (Ctrl+X).
+
+Puis redémarrer NGINX (par exemple en redémarrant le serveur depuis l'interface d'aministration de YunoHost).
+
+#### 3. Télécharger et activer l'application Nextcloud Collabora, sous le nom de "Nextcloud Office"
+
+Dès lors, on peut télécharger l'application "Nextcloud Office" dans Nextcloud, et normalement le serveur CODE est choisi par défaut (sinon voir les paramètres de Nextcloud).
+
 ## Liens utiles
 
 + Site web : [www.collaboraoffice.com](https://www.collaboraoffice.com/)

pages/04.applications/10.docs/converse/app_converse.fr.md

@@ -0,0 +1,25 @@
+---
+title: Converse
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_converse'
+---
+
+[![Installer Converse avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=converse) [![Integration level](https://dash.yunohost.org/integration/converse.svg)](https://dash.yunohost.org/appci/app/converse)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Converse* est un client de chat XMPP gratuit et open-source écrit en JavaScript qui peut être étroitement intégré à n'importe quel site web.
+
+L'avantage d'utiliser converse.js plutôt que de s'appuyer sur une solution SaaS (software-as-a-service) est que vos utilisateurs peuvent bénéficier d'une expérience de chat en ligne beaucoup plus personnalisée, rationalisée et intégrée et que vous avez le contrôle des données. Ce dernier point est une exigence pour de nombreux sites traitant des informations sensibles.
+
+## Liens utiles
+
++ Site web : [conversejs.org](https://conversejs.org/)
++ Démonstration : [Démo](https://inverse.chat/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/converse](https://github.com/YunoHost-Apps/converse_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/converse/issues](https://github.com/YunoHost-Apps/converse_ynh/issues)

pages/04.applications/10.docs/converse/app_converse.md

@@ -0,0 +1,25 @@
+---
+title: Converse
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_converse'
+---
+
+[![Install Converse with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=converse) [![Integration level](https://dash.yunohost.org/integration/converse.svg)](https://dash.yunohost.org/appci/app/converse)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Converse* is a free and open-source XMPP chat client written in JavaScript which can be tightly integrated into any website.
+
+The benefit of using converse.js as opposed to relying on a SaaS (software-as-a-service) solution, is that your users can have a much more customized, streamlined and integrated webchat experience and that you have control over the data. The latter being a requirement for many sites dealing with sensitive information.
+
+## Useful links
+
++ Website: [conversejs.org (en)](https://conversejs.org/)
++ Demonstration: [Demo](https://inverse.chat/)
++ Application software repository: [github.com - YunoHost-Apps/converse](https://github.com/YunoHost-Apps/converse_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/converse/issues](https://github.com/YunoHost-Apps/converse_ynh/issues)

pages/04.applications/10.docs/coturn/app_coturn.fr.md

@@ -0,0 +1,38 @@
+---
+title: Coturn
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_coturn'
+---
+
+[![Installer Coturn avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=coturn) [![Integration level](https://dash.yunohost.org/integration/coturn.svg)](https://dash.yunohost.org/appci/app/coturn)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Coturn* est une implémentation libre et open source de serveurs TURN et STUN.
+Le serveur TURN est un serveur et une passerelle de traversée NAT pour le trafic VoIP. Il peut également être utilisé comme serveur TURN et passerelle de trafic réseau à usage général.
+
+### Avertissements / informations importantes
+
+#### Configuration
+
+Vous devez installer le serveur TURN dans un domaine principal ou un sous-domaine comme turn.domain.tld.
+Comment configurer cette application : un simple fichier avec SSH.
+
+#### Testing
+
+Pour les tests, vous pouvez utiliser l'outil de test Trickle-Ice. Accédez à la page trickle-ice [trickle-ice page](https://webrtc.github.io/samples/src/content/peerconnection/trickle-ice/) et entrez les détails suivants.
+
+TURN URI     : turn:<YOUR_PUBLIC_IP_ADDRESS>:5349
+TURN username: <YOUR_USERNAME>
+TURN password: <YOUR_PASSWORD>
+
+## Liens utiles
+
++ Site web : [github.com/coturn/coturn](https://github.com/coturn/coturn)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/coturn](https://github.com/YunoHost-Apps/coturn_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/coturn/issues](https://github.com/YunoHost-Apps/coturn_ynh/issues)

pages/04.applications/10.docs/coturn/app_coturn.md

@@ -0,0 +1,38 @@
+---
+title: Coturn
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_coturn'
+---
+
+[![Install Coturn with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=coturn) [![Integration level](https://dash.yunohost.org/integration/coturn.svg)](https://dash.yunohost.org/appci/app/coturn)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Coturn* is a Free open source implementation of TURN and STUN Server.
+The TURN Server is a VoIP media traffic NAT traversal server and gateway. It can be used as a general-purpose network traffic TURN server and gateway, too.
+
+### Disclaimers / important information
+
+#### Configuration
+
+You need to install TURN server in a root or subdomain like turn.domain.tld
+How to configure this app: a plain file with SSH.
+
+#### Testing
+
+For testing we can use Trickle-Ice testing tool. Go to [trickle-ice page](https://webrtc.github.io/samples/src/content/peerconnection/trickle-ice/) and enter following details.
+
+TURN URI     : turn:<YOUR_PUBLIC_IP_ADDRESS>:5349
+TURN username: <YOUR_USERNAME>
+TURN password: <YOUR_PASSWORD>
+
+## Useful links
+
++ Website: [github.com/coturn/coturn](https://github.com/coturn/coturn)
++ Application software repository: [github.com - YunoHost-Apps/coturn](https://github.com/YunoHost-Apps/coturn_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/coturn/issues](https://github.com/YunoHost-Apps/coturn_ynh/issues)

pages/04.applications/10.docs/cryptpad/app_cryptpad.fr.md

@@ -0,0 +1,40 @@
+---
+title: CryptPad
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_cryptpad'
+---
+
+[![Installer CryptPad avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=cryptpad) [![Integration level](https://dash.yunohost.org/integration/cryptpad.svg)](https://dash.yunohost.org/appci/app/cryptpad)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*CryptPad* est une suite logicielle chiffrée de bout en bout et ouverte. Elle est conçue pour permettre un travail collaboratif, en synchronisant les modifications apportées aux documents en temps réel. Comme toutes les données sont chiffrées, le service et ses administrateurs n'ont aucun moyen de voir le contenu édité et stocké.
+
+## Avertissements / informations importantes
+
+#### Configuration
+
+Une fois CryptPad installé, créez un compte via le bouton S'inscrire sur la page d'accueil. Pour faire de ce compte un administrateur d'instance :
+
+    Copiez la clé publique trouvée dans le menu utilisateur (avatar en haut à droite) > Paramètres > Compte > Clé de signature publique
+    Collez cette clé dans `/var/www/cryptpad/config/config.js` dans le tableau suivant (décommentez et remplacez l'espace réservé) :
+
+```
+adminKeys: [
+        "[cryptpad-user1@my.awesome.website/YZgXQxKR0Rcb6r6CmxHPdAGLVludrAF2lEnkbx1vVOo=]",
+],
+```
+
+    Redémarrer le service CryptPad (Dans webadmin YunoHost -> Services -> cryptpad -> Redémarrer)
+
+## Liens utiles
+
++ Site web : [cryptpad.fr (fr)](https://cryptpad.fr/)
++ Démonstration : [Démo](https://cryptpad.fr/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/cryptpad](https://github.com/YunoHost-Apps/cryptpad_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/cryptpad/issues](https://github.com/YunoHost-Apps/cryptpad_ynh/issues)

pages/04.applications/10.docs/cryptpad/app_cryptpad.md

@@ -0,0 +1,38 @@
+---
+title: CryptPad
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_cryptpad'
+---
+
+[![Installer CryptPad with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=cryptpad) [![Integration level](https://dash.yunohost.org/integration/cryptpad.svg)](https://dash.yunohost.org/appci/app/cryptpad)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*CryptPad* is a collaboration suite that is end-to-end-encrypted and open-source. It is built to enable collaboration, synchronizing changes to documents in real time. Because all data is encrypted, the service and its administrators have no way of seeing the content being edited and stored.
+
+## Disclaimers / important information
+
+#### Configuration
+
+Once CryptPad is installed, create an account via the Register button on the home page. To make this account an instance administrator:
+
+    Copy the public key found in User Menu (avatar at the top right) > Settings > Account > Public Signing Key
+    Paste this key in `/var/www/cryptpad/config/config.js` in the following array (uncomment and replace the placeholder):
+``` 
+adminKeys: [
+        "[cryptpad-user1@my.awesome.website/YZgXQxKR0Rcb6r6CmxHPdAGLVludrAF2lEnkbx1vVOo=]",
+],
+``` 
+    Restart CryptPad service (In YunoHost webadmin -> Services -> cryptpad -> Restart)
+
+## Useful links
+
++ Website: [cryptpad.fr](https://cryptpad.fr/)
++ Demonstration: [Demo](https://cryptpad.fr/)
++ Application software repository: [github.com - YunoHost-Apps/cryptpad](https://github.com/YunoHost-Apps/cryptpad_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/cryptpad/issues](https://github.com/YunoHost-Apps/cryptpad_ynh/issues)

pages/04.applications/10.docs/cubiks-2048/app_cubiks-2048.fr.md

@@ -0,0 +1,23 @@
+---
+title: Cubiks 2048
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_cubiks-2048'
+---
+
+[![Installer Cubiks 2048 avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=cubiks-2048) [![Integration level](https://dash.yunohost.org/integration/cubiks-2048.svg)](https://dash.yunohost.org/appci/app/cubiks-2048)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Cubiks 2048* est un clone en 3D du jeu 2048.
+
+## Liens utiles
+
++ Site web : [github.com/Kshitij-Banerjee/Cubiks-2048](https://github.com/Kshitij-Banerjee/Cubiks-2048)
++ Démonstration : [Démo](https://kshitij-banerjee.github.io/Cubiks-2048/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/cubiks-2048](https://github.com/YunoHost-Apps/cubiks-2048_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/cubiks-2048/issues](https://github.com/YunoHost-Apps/cubiks-2048_ynh/issues)

pages/04.applications/10.docs/cubiks-2048/app_cubiks-2048.md

@@ -0,0 +1,23 @@
+---
+title: Cubiks 2048
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_cubiks-2048'
+---
+
+[![Installer Cubiks 2048 with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=cubiks-2048) [![Integration level](https://dash.yunohost.org/integration/cubiks-2048.svg)](https://dash.yunohost.org/appci/app/cubiks-2048)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Cubiks 2048* is a clone of 2048 game in 3D.
+
+## Useful links
+
++ Website: [github.com/Kshitij-Banerjee/Cubiks-2048](https://github.com/Kshitij-Banerjee/Cubiks-2048)
++ Demonstration: [Demo](https://kshitij-banerjee.github.io/Cubiks-2048/)
++ Application software repository: [github.com - YunoHost-Apps/cubiks-2048](https://github.com/YunoHost-Apps/cubiks-2048_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/cubiks-2048/issues](https://github.com/YunoHost-Apps/cubiks-2048_ynh/issues)

pages/04.applications/10.docs/dispatch/app_dispatch.fr.md

@@ -0,0 +1,23 @@
+---
+title: Dispatch
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_dispatch'
+---
+
+[![Installer Dispatch avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=dispatch) [![Integration level](https://dash.yunohost.org/integration/dispatch.svg)](https://dash.yunohost.org/appci/app/dispatch)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Dispatch* est un client graphique IRC basé sur une application web.
+
+## Liens utiles
+
++ Site web : [github.com/khlieng/dispatch](https://github.com/khlieng/dispatch)
++ Démonstration : [Démo](https://dispatch.khlieng.com/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/dispatch](https://github.com/YunoHost-Apps/dispatch_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/dispatch/issues](https://github.com/YunoHost-Apps/dispatch_ynh/issues)

pages/04.applications/10.docs/dispatch/app_dispatch.md

@@ -0,0 +1,23 @@
+---
+title: Dispatch
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_dispatch'
+---
+
+[![Installer Dispatch with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=dispatch) [![Integration level](https://dash.yunohost.org/integration/dispatch.svg)](https://dash.yunohost.org/appci/app/dispatch)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Dispatch* is a web-based IRC graphical client.
+
+## Useful links
+
++ Website: [github.com/khlieng/dispatch](https://github.com/khlieng/dispatch)
++ Demonstration: [Demo](https://dispatch.khlieng.com/)
++ Application software repository: [github.com - YunoHost-Apps/dispatch](https://github.com/YunoHost-Apps/dispatch_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/dispatch/issues](https://github.com/YunoHost-Apps/dispatch_ynh/issues)

pages/04.applications/10.docs/domoticz/app_domoticz.fr.md

@@ -0,0 +1,129 @@
+---
+title: Domoticz
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_domoticz'
+---
+
+[![Installer Domoticz avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=domoticz) [![Integration level](https://dash.yunohost.org/integration/domoticz.svg)](https://dash.yunohost.org/appci/app/domoticz)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Domoticz* est un système domotique open source très léger qui vous permet de surveiller et de configurer divers appareils.
+
+### Avertissements/informations importantes
+
+Domoticz est un système de domotique permettant de controler différents objets et de recevoir des données de divers senseurs Il peut par exemple être utilisé avec :
+
+    des interrupteurs
+    des senseurs de portes
+    des sonnettes d'entrées
+    des systèmes de sécurité
+    des stations météo pour les UV, la pluie, le vent...
+    des sondes de températures
+    des sondes d'impulsions
+    des voltmètres et bien d'autres
+
+Version incluse : Toujours la dernière version stable. La dernière version compilée est récupérée dans ce répertoire lors de l'installation. Une fois installée, les mises à jour de l'application sont gérées depuis les menus de l'application elle même. Le script de mise à jour YunoHost mettra uniquement à jour de nouvelles version du package.
+
+Le broker MQTT Mosquitto est intégré au package et nécessite un sous-domaine ou un domaine distinct. Il est optionnel et si vous indiquez lors de l'installation le même domaine que le domaine principal, il ne sera pas installé.
+
+### Configuration
+
+#### Broker MQTT Mosquitto
+
+À l'installation, un broker MQTT, Mosquitto, est installé en même temps que Domoticz. La version installée est celle du dépot officiel du projet, et non des dépots Debian. Ce broker nécessite un domaine ou un sous-domaine particulier pour fonctionner (ex : mqtt.your.domain.tld). Il est nécessaire de créer ce domaine auparavant.
+
+##### Ajout dans Domoticz
+
+Pour pouvoir l'utiliser, vous devez paramétrer la communication avec entre Domoticz et le broker en suivant la documentation de Domoticz dans la partie Add hardware "MQTT Client Gateway". Les utilisateurs et mot de passe du broker sont automatiquement générés lors de l'installation. Vous pouvez les récupérer avec
+```
+sudo yunohost app setting domoticz mqtt_user
+sudo yunohost app setting domoticz mqtt_pwd
+```
+
+##### Publier/souscrire
+
+Par défaut, Mosquitto va écouter sur deux ports :
+
+    Le 1883 sur localhost en protocole MQTT
+    Le 8883 en protocole WebSocket. NGINX redirige le port 443 externe vers ce port en interne. Pour publier/souscrire sur un topic depuis l'exterieur, vous devez donc utiliser un programme supportant le protocole WebSocket (ex : la bibliothèque Python paho-mqtt).
+
+##### Mosquitto_pub et mosquitto_sub
+
+Ces deux programmes ne supportent pas le protocole WebSocket mais uniquement le MQTT : le paramétrage de base ne vous autorise donc pas à les utiliser pour communiquer depuis un client externe. Si vous les utilisez directement depuis votre serveur, ce genre de syntaxe devrait marcher :
+
+`mosquitto_pub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/in' -m '{ "idx" : 1, "nvalue" : 0, "svalue" : "25.0" }'`
+
+De la même manière :
+
+`mosquitto_sub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/out'`
+
+Si vous souhaitez ouvrir le protocole MQTT depuis l'extérieur afin de pouvoir les utiliser depuis un autre serveur, il vous faudra :
+
+    ouvrir le port 1883 sur le firewall YunoHost (attention, risque de sécurité)
+    autoriser les adresses IP souhaitées dans la configuration de Mosquitto
+    paramétrer le TLS dans la configuration de Mosquitto en donnant accès au crt.pem et key.pem de votre domaine MQTT en les paramétrant respectivement avec les variables certfile et keyfile. Ceci est obligatoire pour sécuriser la connexion.
+
+##### Mise à jour depuis les versions n'ayant pas Mosquitto
+
+Si vous êtes sur le package ynh3 ou inférieur, Mosquitto n'est pas installé par défaut. De même si vous avez choisi de ne pas indiquer de domaine pour Mosquitto lors de l'installation initiale. Pour pouvoir l'installer après coup, effectuez les actions suivantes :
+
+    créez un domaine ou sous-domaine pour recevoir les informations (par exemple : 'mqtt.your.domain.tld')
+    connecter vous en ligne de commande à votre serveur
+    tapez la commande suivante : `yunohost app setting domoticz mqtt_domain -v mqtt.your.domain.tld`
+    Procédez à la mise à jour. Si vous êtes déjà sur la dernière version, utiliser la commmande suivante : `yunohost app upgrade domoticz --force`
+
+### Configuration
+
+#### Capteurs, langue...
+
+Toute la configuration de l'application a lieu dans l'application elle-même.
+
+#### Access et API
+
+Par défaut, l'accès aux API JSON est autorisé sur cette URL `/votredomaine.tld/api_/chemindedomoticz`. Donc, si vous accédez à domoticz par `https://votredomaine.tld/domoticz`, utilisez le chemin suivant pour l'api : `/votredomaine.tld/api_/domoticz/json.htm?votrecommandeapi`
+
+Par défaut, seuls la mise à jour de capteur et les interrupteurs sont autorisés. Pour autoriser une nouvelle commande, vous devez (pour l'instant) manuellement éditer le fichier de configuration NGINX :
+
+`sudo nano /etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf`
+
+Puis éditer le bloc suivant en y ajoutant le regex de la commmande à autoriser :
+```
+  #set the list of authorized json command here in regex format
+  #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's
+  #By default, sensors updates and toggle switch are authorized
+  if ( $args ~* type=command&param=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command&param=switchlight&idx=[0-9]*&switchcmd=Toggle$) {
+    set $api "1";
+    }
+```
+
+Par exemple, pour ajouter la commmande json pour retrouver le statut d'un équipement (`/json.htm?type=devices&rid=IDX`),il faut modifier la ligne comme ceci :
+```
+  #set the list of authorized json command here in regex format
+  #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's
+  #By default, sensors updates and toggle switch are authorized
+  if ( $args ~* type=command&param=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command&param=switchlight&idx=[0-9]*&switchcmd=Toggle$|type=devices&rid=[0-9]* ) {
+    set $api "1";
+    }
+```
+Toutes les adresses IPv4 du réseau local (192.168.0.0/24) et toutes les adresses IPv6 sont autorisées pour l'API. À ma connaissance, il n'y a pas moyen d'effectuer un filtre pour les adresses IPv6 sur le réseau local, vous pouvez donc retirer leur autorisation en enlevant ou en commentant la ligne suivante dans `/etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf` :
+
+`allow ::/1;`
+
+Ceci autorisera seulement les adresses IPv4 local a accéder aux API de Domoticz. Vous pouvez ajouter des adresses IPv6 de la même façon.
+
+### Limitations
+
+    Pas de gestion d'utilisateurs ni d'intégration LDAP. L'application ne prévoit pas de gérer les utilisateurs par LDAP, donc le package non plus.
+    Un backup ne peut pas être restauré sur un type de machine différente de celle d'origine (x86, arm...) car les sources compilées doivent être différentes
+
+## Liens utiles
+
++ Site web : [domoticz.com](https://domoticz.com/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/domoticz](https://github.com/YunoHost-Apps/domoticz_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/domoticz/issues](https://github.com/YunoHost-Apps/domoticz_ynh/issues)

pages/04.applications/10.docs/domoticz/app_domoticz.md

@@ -0,0 +1,136 @@
+---
+title: Domoticz
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_domoticz'
+---
+
+[![Installer Domoticz with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=domoticz) [![Integration level](https://dash.yunohost.org/integration/domoticz.svg)](https://dash.yunohost.org/appci/app/domoticz)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Domoticz* is a very light weight open sources home automation system that lets you monitor and configure miscellaneous devices.
+
+### Disclaimers/important information
+
+Domoticz is a Home Automation system design to control various devices and receive input from various sensors. For example this system can be used with:
+
+    Light switches
+    Door sensors
+    Doorbells
+    Security devices
+    Weather sensors like: UV/Rain/Wind Meters
+    Temperature Sensors
+    Pulse Meters
+    Voltage/AD Meters and more
+
+Shipped version: Always the last stable one. The last compiled version is retrieved from this directory during install. Once installed, updates from the uptream app are managed from within the app. YunoHost upgrade script will only upgrade the YunoHost package.
+
+The MQTT broker Mosquitto is integrated into the package. It requires its own domain or subdomain. It's an optional setting: during install if you set the same domaine as your main app domain, it won't be installed.
+
+### Configuration
+
+#### Broker Mosquitto
+
+During installation, a MQTT broker, Mosquitto, is installed at the same time as Domoticz. The installed version is the one from the official project repo and not from Debian ones. This broker requires a dedicated domain or subdomain to work (ex : mqtt.your.domain.tld): creating this domain prior installation is a prerequisite.
+
+##### Adding in Domoticz
+
+To use Mosquitto, you need to customize the communication between Domoticz and the broker by following the Domoticz documentation, part Add hardware "MQTT Client Gateway". User and password are automatically generated during installation, you may retrieve them with
+``` 
+sudo yunohost app setting domoticz mqtt_user
+sudo yunohost app setting domoticz mqtt_pwd
+```
+
+##### Publish/Subscribe
+
+By default, Mosquitto will listen on two ports:
+
+    1883 on localhost using mqtt protocol
+    8883 using websocket protocol. NGINX redirect external port 443 to this internal port.
+
+Hence, To publish/subscribe on a topic from the outside, you have to use a software supporting WebSocket protocol (ex: paho-mqtt Python library).
+
+##### Mosquitto_pub et mosquitto_sub
+
+These two tools do not support WebSocket protocol, only direct MQTT: base settings will not allow communication from an outside device. If you're using them directly from your server, this kind of syntax should work:
+```
+mosquitto_pub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/in' -m '{ "idx" : 1, "nvalue" : 0, "svalue" : "25.0" }'
+```
+In the same way:
+
+```
+mosquitto_sub -u *user* -P *password* -h mqtt.your.domain.tld -p 1883 -t 'domoticz/out'
+```
+
+If you wish to open direct MQTT protocol from an outside device, you'll need to:
+
+    open port 1883 on Yunohost firewall (Attention, security risk)
+    Allows IP addresses in mosquitto configuration for this listener
+    Set the TLS setting in mosquitto configuration by giving access to crt.pem and key.pem from your MQTT domain by setting respective certfile et keyfile variables. This is mandatory to ensure a secure connection.
+
+##### Upgrade from version without Mosquitto
+
+If you have package ynh3 or below, Mosquitto is not installed by default. If you have chosen to not set a domain during initial installation also. So, if you need to activate mosquitto in retrospect, do following actions:
+
+    Create a domain or a subdomain (for example : 'mqtt.your.domain.tld')
+    Connect to your server in command line
+    Type following command: `yunohost app setting domoticz mqtt_domain -v mqtt.your.domain.tld`
+    Upgrade domoticz to last package. If you're already on the last package version, use the following command: `yunohost app upgrade domoticz --force`
+
+### Configuration
+
+Sensors, language...
+
+Main configuration of the app take place inside the app itself.
+
+#### Access and API
+
+By default, access for the JSON API is allowed on following path `/yourdomain.tld/api_/domoticzpath`. So if you access domoticz via `https://mydomainname.tld/domoticz`, use the following webpath for the api: `/mydomainname.tld/api_/domoticz/json.htm?yourapicommand`
+
+By default, only sensor updates and switch toogle are authorized. To authorized a new command, you have (for now) to manually update the NGINX config file:
+
+sudo nano `/etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf`
+
+Then edit the following block by adding the regex of the command you want to allow:
+
+  #set the list of authorized json command here in regex format
+  #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's
+  #By default, sensors updates and toggle switch are authorized
+  ```
+  if ( $args ~* type=command&param=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command&param=switchlight&idx=[0-9]*&switchcmd=Toggle$) {
+    set $api "1";
+    }
+  ```
+For example, to add the JSON command to retrieve the status of a device (`/json.htm?type=devices&rid=IDX`),modify the line as this:
+
+  #set the list of authorized json command here in regex format
+  #you may retrieve the command from https://www.domoticz.com/wiki/Domoticz_API/JSON_URL's
+  #By default, sensors updates and toggle switch are authorized
+  ```
+  if ( $args ~* type=command&param=udevice&idx=[0-9]*&nvalue=[0-9]*&svalue=.*$|type=command&param=switchlight&idx=[0-9]*&switchcmd=Toggle$|type=devices&rid=[0-9]* ) {
+    set $api "1";
+    }
+  ```
+
+All IPv4 addresses within the local network (192.168.0.0/24) and all IPv6 addresses are authorized as API. As far as I know, there is no way to filter for IPv6 address on local network: You may remove the authorization by removing or commenting this line in `/etc/nginx/conf.d/yourdomain.tld.d/domoticz.conf`:
+
+`allow ::/1;`
+
+This will authorized only IPv4 within local network to access your Domoticz API. You may add individual IPv6 address in the same way.
+
+### Limitations
+
+    No user management nor LDAP integration This function is not planned to be implemented into the app, hence it's not planned into the package neither.
+    Backup cannot be restored on a different machine type (arm, x86...) as compiled sources are different
+
+
+## Useful links
+
++ Website: [domoticz.eu (en)](https://domoticz.eu/site/)
++ Application software repository: [github.com - YunoHost-Apps/domoticz](https://github.com/YunoHost-Apps/domoticz_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/domoticz/issues](https://github.com/YunoHost-Apps/domoticz_ynh/issues)

pages/04.applications/10.docs/droppy/app_droppy.fr.md

@@ -0,0 +1,31 @@
+---
+title: Droppy
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_droppy'
+---
+
+[![Installer Droppy avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=droppy) [![Integration level](https://dash.yunohost.org/integration/droppy.svg)](https://dash.yunohost.org/appci/app/droppy)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Droppy* est un serveur de stockage de fichiers auto-hébergé avec une interface web et des capacités pour éditer des fichiers et visualiser des médias directement dans le navigateur.
+
+### Avertissements / informations importantes
+
+Le développement de Droppy a été abandonné par son auteur, et son dépôt de code a été archivé. N'attendez pas de future mise à jour, ni correctifs de sécurité.
+
+### Configuration
+
+Comment configurer cette application : un fichier de configuration /var/www/droppy/config/config.json en SSH.
+Les fichiers partagés sont stockés dans le répertoire suivant : /home/yunohost.app/droppy/files/
+
+## Liens utiles
+
++ Site web : [github.com/silverwind/droppy](https://github.com/silverwind/droppy)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/droppy](https://github.com/YunoHost-Apps/droppy_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/droppy/issues](https://github.com/YunoHost-Apps/droppy_ynh/issues)

pages/04.applications/10.docs/droppy/app_droppy.md

@@ -0,0 +1,31 @@
+---
+title: Droppy
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_droppy'
+---
+
+[![Installer Droppy with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=droppy) [![Integration level](https://dash.yunohost.org/integration/droppy.svg)](https://dash.yunohost.org/appci/app/droppy)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Droppy* is a self-hosted file storage server with a web interface and capabilities to edit files and view media directly in the browser.
+
+### Disclaimers / important information
+
+Development of Droppy has been abandoned by its author, and its repository has been archived. Expect no future updates nor security fixes.
+
+### Configuration
+
+How to configure this app: a JSON configuration file with SSH. `/var/www/droppy/config/config.json.`
+Shared files are stored in the following directory: `/home/yunohost.app/droppy/files`
+
+## Useful links
+
++ Website: [github.com/silverwind/droppy](https://github.com/silverwind/droppy)
++ Application software repository: [github.com - YunoHost-Apps/droppy](https://github.com/YunoHost-Apps/droppy_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/droppy/issues](https://github.com/YunoHost-Apps/droppy_ynh/issues)

pages/04.applications/10.docs/easyappointments/app_easyappointments.fr.md

@@ -0,0 +1,23 @@
+---
+title: Easy!Appointments
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_easyappointments'
+---
+
+[![Installer Easy!Appointments avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=easyappointments) [![Integration level](https://dash.yunohost.org/integration/easyappointments.svg)](https://dash.yunohost.org/appci/app/easyappointments)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Easy!Appointments* est une application web hautement personnalisable qui permet aux clients de prendre rendez-vous avec vous via une interface web sophistiquée. De plus, elle offre la possibilité de synchroniser vos données avec Google Calendar afin que vous puissiez les utiliser avec d'autres services. Il s'agit d'un projet open source que vous pouvez télécharger et installer même pour un usage commercial. Easy!Appointments fonctionnera sans problème avec votre site web existant car il peut être installé dans un seul dossier du serveur et bien sûr partager une base de données existante.
+
+## Liens utiles
+
++ Site web : [easyappointments.org](https://easyappointments.org/)
++ Démonstration : [Démo](https://demo.easyappointments.org/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/easyappointments](https://github.com/YunoHost-Apps/easyappointments_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/easyappointments/issues](https://github.com/YunoHost-Apps/easyappointments_ynh/issues)

pages/04.applications/10.docs/easyappointments/app_easyappointments.md

@@ -0,0 +1,23 @@
+---
+title: Easy!Appointments
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_easyappointments'
+---
+
+[![Installer Easy!Appointments with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=easyappointments) [![Integration level](https://dash.yunohost.org/integration/easyappointments.svg)](https://dash.yunohost.org/appci/app/easyappointments)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Easy!Appointments* is a highly customizable web application that allows customers to book appointments with you via a sophisticated web interface. Moreover, it provides the ability to sync your data with Google Calendar so you can use them with other services. It is an open source project that you can download and install even for commercial use. Easy!Appointments will run smoothly with your existing website as it can be installed in a single folder of the server and of course share an existing database.
+
+## Useful links
+
++ Website: [easyappointments.org](https://easyappointments.org/)
++ Demonstration: [Demo](https://demo.easyappointments.org/)
++ Application software repository: [github.com - YunoHost-Apps/easyappointments](https://github.com/YunoHost-Apps/easyappointments_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/easyappointments/issues](https://github.com/YunoHost-Apps/easyappointments_ynh/issues)

pages/04.applications/10.docs/element/app_element.fr.md

@@ -0,0 +1,35 @@
+---
+title: Element
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_element'
+---
+
+[![Installer Element avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=element) [![Integration level](https://dash.yunohost.org/integration/element.svg)](https://dash.yunohost.org/appci/app/element)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Element* est un nouveau type d'application de messagerie. Vous choisissez où vos messages sont stockés, ce qui vous donne le contrôle de vos données. Il vous donne accès au réseau ouvert Matrix, vous pouvez donc parler à n'importe qui. Element offre un nouveau niveau de sécurité, en ajoutant la vérification des appareils par signature croisée au chiffrement de bout en bout par défaut.
+
+### Fonctionnalités spécifiques à YunoHost
+
+Prise en charge multi-utilisateurs
+
+Cette application prend en charge le SSO. Si vous souhaitez utiliser le SSO, vous devez définir le chemin d'accès au serveur domestique par défaut car votre serveur domestique est installé sur votre instance YunoHost.
+
+### Informations supplémentaires
+
+Note de sécurité importante
+
+Nous vous déconseillons d'exécuter Element à partir du même nom de domaine que votre Matrix serveur domestique (Synapse). La raison en est le risque de XSS (cross-site-scripting) vulnérabilités qui pourraient survenir si quelqu'un provoquait le chargement et le rendu d'Element un utilisateur malveillant a généré du contenu à partir d'une API Matrix qui avait alors fait confiance accès à Element (ou à d'autres applications) en raison du partage du même domaine.
+
+## Liens utiles
+
++ Site web : [element.io (fr)](https://element.io/)
++ Démonstration : [Démo](https://app.element.io/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/element](https://github.com/YunoHost-Apps/element_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/element/issues](https://github.com/YunoHost-Apps/element_ynh/issues)

pages/04.applications/10.docs/element/app_element.md

@@ -0,0 +1,35 @@
+---
+title: Element
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_element'
+---
+
+[![Installer Element with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=element) [![Integration level](https://dash.yunohost.org/integration/element.svg)](https://dash.yunohost.org/appci/app/element)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Element* is a new type of messaging app. You choose where your messages are stored, putting you in control of your data. It gives you access to the Matrix open network, so you can talk to anyone. Element provides a new level of security, adding cross-signed device verification to default end-to-end encryption.
+
+### YunoHost specific features
+
+Multi-users support
+
+This application support the SSO. If you want to use the SSO, you need to define the path to the default homeserver as your homeserver witch is installed on your YunoHost instance.
+
+### Additional informations
+
+Important Security Note
+
+We do not recommend running Element from the same domain name as your Matrix homeserver (Synapse). The reason is the risk of XSS (cross-site-scripting) vulnerabilities that could occur if someone caused Element to load and render malicious user generated content from a Matrix API which then had trusted access to Element (or other apps) due to sharing the same domain.
+
+## Useful links
+
++ Website: [element.io (en)](https://element.io/)
++ Demonstration: [Demo](https://app.element.io/)
++ Application software repository: [github.com - YunoHost-Apps/element](https://github.com/YunoHost-Apps/element_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/element/issues](https://github.com/YunoHost-Apps/element_ynh/issues)

pages/04.applications/10.docs/emailpoubelle/app_emailpoubelle.fr.md

@@ -0,0 +1,30 @@
+---
+title: EmailPoubelle
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_emailpoubelle'
+---
+
+[![Installer EmailPoubelle avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=emailpoubelle) [![Integration level](https://dash.yunohost.org/integration/emailpoubelle.svg)](https://dash.yunohost.org/appci/app/emailpoubelle)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*EmailPoubelle* est un script pour créer des adresses email temporaires qui pointent vers votre adresse email réelle.
+Une version YunoHost de EmailPoubelle par David Mercereau : un grand merci lui.
+
+### Avertissements / informations importantes
+
+AVERTISSEMENT
+
+L'utilisation de cette fonction va entraîner la désactivation des alias LDAP de YunoHost ! Une fois installé, vous ne pourrez plus utiliser les paramètres des alias que vous pouvez voir lorsque vous modifiez vos paramètres personnels dans le panneau SSOWAT. Bien sûr, une fois désinstallé, tout revient à la normale.
+
+## Liens utiles
+
++ Site web : [framagit.org/kepon/emailPoubellePhp](https://framagit.org/kepon/emailPoubellePhp)
++ Démonstration : [Démo](https://poubelle.zici.fr/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/emailpoubelle](https://github.com/YunoHost-Apps/emailpoubelle_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/emailpoubelle/issues](https://github.com/YunoHost-Apps/emailpoubelle_ynh/issues)

pages/04.applications/10.docs/emailpoubelle/app_emailpoubelle.md

@@ -0,0 +1,30 @@
+---
+title: EmailPoubelle
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_emailpoubelle'
+---
+
+[![Installer EmailPoubelle with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=emailpoubelle) [![Integration level](https://dash.yunohost.org/integration/emailpoubelle.svg)](https://dash.yunohost.org/appci/app/emailpoubelle)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*EmailPoubelle* (Trash email) is a script to create temporay email adresses that aims to your real email address.
+A YunoHost version of EmailPoubelle by David Mercereau. All thanks to David.
+
+### Disclaimers / important information
+
+WARNING
+
+Using this will cause to disable the YunoHost LDAP aliases ! Once installed, you won't be able to use the aliasses settings that you can see when you modify your personnal settings in the SSOWAT pannel. Of course, once uninstalled, everything get back to normal.
+
+## Useful links
+
++ Website: [framagit.org/kepon/emailPoubellePhp](https://framagit.org/kepon/emailPoubellePhp)
++ Demonstration: [Demo](https://poubelle.zici.fr/)
++ Application software repository: [github.com - YunoHost-Apps/emailpoubelle](https://github.com/YunoHost-Apps/emailpoubelle_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/emailpoubelle/issues](https://github.com/YunoHost-Apps/emailpoubelle_ynh/issues)

pages/04.applications/10.docs/encryptic/app_encryptic.fr.md

@@ -0,0 +1,23 @@
+---
+title: Encryptic
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_encryptic'
+---
+
+[![Installer Encryptic avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=encryptic) [![Integration level](https://dash.yunohost.org/integration/encryptic.svg)](https://dash.yunohost.org/appci/app/encryptic)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Encryptic* (fork de Laverna) est un système anonyme, chiffré et sans inscription requise, il est accessible via un navigateur web (sans installation de logiciel). Les données sont privées car elles sont stockées par défaut sur votre machine (InnoDB et localstorage), c'est un réglage dans les paramètres qui vous permettra de les synchroniser via le cloud sur vos différents appareils.
+
+## Liens utiles
+
++ Site web : [encryptic.org](https://www.encryptic.org/)
++ Démonstration : [Démo](https://app.encryptic.org/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/encryptic](https://github.com/YunoHost-Apps/encryptic_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/encryptic/issues](https://github.com/YunoHost-Apps/encryptic_ynh/issues)

pages/04.applications/10.docs/encryptic/app_encryptic.md

@@ -0,0 +1,23 @@
+---
+title: Encryptic
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_encryptic'
+---
+
+[![Installer Encryptic with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=encryptic) [![Integration level](https://dash.yunohost.org/integration/encryptic.svg)](https://dash.yunohost.org/appci/app/encryptic)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Encryptic* (fork of Laverna) is an anonymous system, encrypted and without registration required, it is accessible via a web browser (without software installation). The data is private because it is stored by default on your machine (InnoDB and localstorage), it is a setting in the settings that will allow you to synchronize it via the cloud on your various devices.
+
+## Useful links
+
++ Website: [encryptic.org](https://www.encryptic.org/)
++ Demonstration: [Demo](https://app.encryptic.org/)
++ Application software repository: [github.com - YunoHost-Apps/encryptic](https://github.com/YunoHost-Apps/encryptic_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/encryptic/issues](https://github.com/YunoHost-Apps/encryptic_ynh/issues)

pages/04.applications/10.docs/epicyon/app_epicyon.fr.md

@@ -0,0 +1,22 @@
+---
+title: Epicyon
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_epicyon'
+---
+
+[![Installer Epicyon avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=epicyon) [![Integration level](https://dash.yunohost.org/integration/epicyon.svg)](https://dash.yunohost.org/appci/app/epicyon)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Epicyon* est un Serveur ActivityPub mettant en œuvre les protocoles S2S et C2S, adapté aux ordinateurs monocartes. Comprend des fonctionnalités telles que des outils de modération, l'expiration des messages, des avertissements sur le contenu et des descriptions d'images.
+
+## Liens utiles
+
++ Site web : [epicyon.net](https://epicyon.net/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/epicyon](https://github.com/YunoHost-Apps/epicyon_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/epicyon/issues](https://github.com/YunoHost-Apps/epicyon_ynh/issues)

pages/04.applications/10.docs/epicyon/app_epicyon.md

@@ -0,0 +1,22 @@
+---
+title: Epicyon
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_epicyon'
+---
+
+[![Installer Epicyon with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=epicyon) [![Integration level](https://dash.yunohost.org/integration/epicyon.svg)](https://dash.yunohost.org/appci/app/epicyon)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Epicyon* is an ActivityPub server implementing S2S and C2S protocols, suitable for single board computers. Includes features such as moderation tools, post expiry, content warnings, and image descriptions.
+
+## Useful links
+
++ Website: [epicyon.net](https://epicyon.net/)
++ Application software repository: [github.com - YunoHost-Apps/epicyon](https://github.com/YunoHost-Apps/epicyon_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/epicyon/issues](https://github.com/YunoHost-Apps/epicyon_ynh/issues)

pages/04.applications/10.docs/facette/app_facette.fr.md

@@ -0,0 +1,23 @@
+---
+title: Facette
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_facette'
+---
+
+[![Installer Facette avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=facette) [![Integration level](https://dash.yunohost.org/integration/facette.svg)](https://dash.yunohost.org/appci/app/facette)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Facette* est une application web qui permet d'afficher des séries de données temporelles provenant de diverses sources - telles que collectd, Graphite, InfluxDB ou KairosDB - sur des graphiques, conçue pour être facile à configurer et à utiliser.
+
+## Liens utiles
+
++ Site web : [facette.io](https://facette.io/)
++ Démonstration : [Démo](https://play.facette.io/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/facette](https://github.com/YunoHost-Apps/facette_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/facette/issues](https://github.com/YunoHost-Apps/facette_ynh/issues)

pages/04.applications/10.docs/facette/app_facette.md

@@ -0,0 +1,23 @@
+---
+title: Facette
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_facette'
+---
+
+[![Installer Facette with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=facette) [![Integration level](https://dash.yunohost.org/integration/facette.svg)](https://dash.yunohost.org/appci/app/facette)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Facette* is a web application to display time series data from various sources — such as collectd, Graphite, InfluxDB or KairosDB — on graphs, designed to be easy to setup and to use.
+
+## Useful links
+
++ Website: [facette.io](https://facette.io/)
++ Demonstration: [Demo](https://play.facette.io/)
++ Application software repository: [github.com - YunoHost-Apps/facette](https://github.com/YunoHost-Apps/facette_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/facette/issues](https://github.com/YunoHost-Apps/facette_ynh/issues)

pages/04.applications/10.docs/facilmap/app_facilmap.fr.md

@@ -0,0 +1,23 @@
+---
+title: Facilmap
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_facilmap'
+---
+
+[![Installer Facilmap avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=facilmap) [![Integration level](https://dash.yunohost.org/integration/facilmap.svg)](https://dash.yunohost.org/appci/app/facilmap)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Facilmap* est une carte collaborative avec une interface simple et pratique.
+
+## Liens utiles
+
++ Site web : [facilmap.org](https://facilmap.org/)
++ Démonstration : [Démo](https://facilmap.org/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/facilmap](https://github.com/YunoHost-Apps/facilmap_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/facilmap/issues](https://github.com/YunoHost-Apps/facilmap_ynh/issues)

pages/04.applications/10.docs/facilmap/app_facilmap.md

@@ -0,0 +1,23 @@
+---
+title: Facilmap
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_facilmap'
+---
+
+[![Installer Facilmap with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=facilmap) [![Integration level](https://dash.yunohost.org/integration/facilmap.svg)](https://dash.yunohost.org/appci/app/facilmap)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Facilmap* is a collaborative maps and routing with a straightforward interface.
+
+## Useful links
+
++ Website: [facilmap.org](https://facilmap.org/)
++ Demonstration: [Demo](https://facilmap.org/)
++ Application software repository: [github.com - YunoHost-Apps/facilmap](https://github.com/YunoHost-Apps/facilmap_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/facilmap/issues](https://github.com/YunoHost-Apps/facilmap_ynh/issues)

pages/04.applications/10.docs/focalboard/app_focalboard.fr.md

@@ -0,0 +1,22 @@
+---
+title: Focalboard
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_focalboard'
+---
+
+[![Installer Focalboard avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=focalboard) [![Integration level](https://dash.yunohost.org/integration/focalboard.svg)](https://dash.yunohost.org/appci/app/focalboard)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Focalboard* est un outil de gestion de projet qui aide à définir, organiser, suivre et gérer le travail entre les équipes, à l'aide d'une vue de tableau kanban familière.
+
+## Liens utiles
+
++ Site web : [focalboard.com](https://www.focalboard.com/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/focalboard](https://github.com/YunoHost-Apps/focalboard_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/focalboard/issues](https://github.com/YunoHost-Apps/focalboard_ynh/issues)

pages/04.applications/10.docs/focalboard/app_focalboard.md

@@ -0,0 +1,22 @@
+---
+title: Focalboard
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_focalboard'
+---
+
+[![Installer Focalboard with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=focalboard) [![Integration level](https://dash.yunohost.org/integration/focalboard.svg)](https://dash.yunohost.org/appci/app/focalboard)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Focalboard* is a project management tool that helps define, organize, track and manage work across teams, using a familiar kanban board view.
+
+## Useful links
+
++ Website: [focalboard.com](https://www.focalboard.com/)
++ Application software repository: [github.com - YunoHost-Apps/focalboard](https://github.com/YunoHost-Apps/focalboard_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/focalboard/issues](https://github.com/YunoHost-Apps/focalboard_ynh/issues)

pages/04.applications/10.docs/galette/app_galette.fr.md

@@ -0,0 +1,46 @@
+---
+title: Galette
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_galette'
+---
+
+![logo de Galette](https://galette.eu/site/assets/img/galette.png?resize=,80)
+
+[![Installer Galette avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=galette) [![Integration level](https://dash.yunohost.org/integration/galette.svg)](https://dash.yunohost.org/appci/app/galette)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Galette* est une application web de gestion d’adhérents et de cotisations en ligne à destination des associations. C’est avant toute chose un logiciel libre, communautaire, et gratuit ! Galette fonctionne sur n’importe quel serveur web qui prend en charge PHP.
+
+### Mise à jour de l'application
+
+Une fois la mise à jour de l'application faite, vous devez vous rendre sur la page de l'installeur qui par défaut est de la forme `https://domaine/galette/installer.php`.
+
+Une fois sur cette page, une vérification des prérequis est affiché.
+À l'étape suivante vous allez devoir choisir le type d'installation : ici `Mise à jour`.
+
+![Galette MAJ](https://github.com/YunoHost/doc/raw/master/images/Galette_1_fr_MAJ.png)
+
+C'est à cette nouvelle étape, où les champs sont pré-remplis, qu'il va falloir renseigner le mot de passe de la base de données.
+
+![Galette MdP](https://github.com/YunoHost/doc/raw/master/images/Galette_2_fr_MdP.png)
+
+Vous allez pouvoir le retrouver en vous connectant en SSH à votre serveur. Il faudra passer en root et afficher le fichier `config.inc.php` dans lequel se trouve le mot de passe de l'application :
+
+```
+sudo su
+
+cat /var/www/galette/galette/config/config.inc.php
+```
+
+## Liens utiles
+
++ Site web : [galette.eu (fr)](https://galette.eu/site/fr/)
++ Démonstration : [Démo](https://demo.galette.eu/login)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/galette](https://github.com/YunoHost-Apps/galette_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/galette/issues](https://github.com/YunoHost-Apps/galette_ynh/issues)

pages/04.applications/10.docs/galette/app_galette.md

@@ -0,0 +1,46 @@
+---
+title: Galette
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_galette'
+---
+
+![logo of Galette](https://galette.eu/site/assets/img/galette.png?resize=,80)
+
+[![Installer Galette avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=galette) [![Integration level](https://dash.yunohost.org/integration/galette.svg)](https://dash.yunohost.org/appci/app/galette)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Galette* is a membership management web application towards non profit organizations. This is before all a free software (as in free speech), community and free (as in beer)! Galette works on any web server that handle PHP.
+
+### Updating the application
+
+Once you have updated the application, you must go to the installer page which by default is `https://domaine/galette/installer.php`.
+
+Once on this page, a verification of the prerequisites is displayed.
+At the next step you will have to choose the type of installation: here `Update`.
+
+![Galette Update](https://github.com/YunoHost/doc/raw/master/images/Galette_1_en_Update.png)
+
+It is at this new step, where the fields are pre-filled, that you will have to fill in the database password.
+
+![Galette Password](https://github.com/YunoHost/doc/raw/master/images/Galette_2_en_Passwd.png)
+
+You will be able to find it by connecting to your server with SSH. You will have to switch to `root` and display the `config.inc.php` file in which the application password is located:
+
+```
+sudo su
+
+cat /var/www/galette/galette/config/config.inc.php
+```
+
+## Useful links
+
++ Website: [galette.eu (en)](https://galette.eu/site/)
++ Demonstration: [Démo](https://demo.galette.eu/login)
++ Application software repository: [github.com - YunoHost-Apps/galette](https://github.com/YunoHost-Apps/galette_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/galette/issues](https://github.com/YunoHost-Apps/galette_ynh/issues)

pages/04.applications/10.docs/gemserv/app_gemserv.fr.md

@@ -0,0 +1,60 @@
+---
+title: Gemserv
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_gemserv'
+---
+
+[![Installer Gemserv avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=gemserv) [![Integration level](https://dash.yunohost.org/integration/gemserv.svg)](https://dash.yunohost.org/appci/app/gemserv)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Gemserv* est un serveur Gemini écrit en Rust.
+
+### Avertissements / informations importantes
+
+Gemserv utilise le port TCP 1965, vous ne pourrez donc l'utiliser pour autre chose.
+
+Pour ajouter une capsule, créer le fichier de configuration `/etc/gemserv/config.d/example.toml` avec le contenu suivant :
+
+```
+[[server]]
+hostname = "yourdomain.org"
+dir = "/opt/yunohost/gemserv"
+key = "/etc/yunohost/certs/yourdomain.org/key.pem"
+cert = "/etc/yunohost/certs/yourdomain.org/crt.pem"
+# index is optional but defaults to index.gemini. The server will serve files
+# ending in gemini or gmi.
+index = "index.gmi"
+# lang is optional
+lang = "en"
+# cgi is optional bool
+cgi = true
+# cgipath is optional and only checked if cgi is true. It restricts cgi to only
+# this directory.
+cgipath = "/path/to/cgi-bin/"
+# scgi is optional
+scgi = { "/scgi" = "localhost:4000" }
+# cgienv is optional
+cgienv = { "GIT_PROJECT_ROOT" = "/srv/git" }
+# usrdir is optional. it'll look in each user's ~/public_gemini
+usrdir = true
+# proxy is optional
+# path is what comes after the hostname e.g. example.com/path
+proxy = { path = "localhost:1966" }
+# proxy_all is optional
+# It will send all requests to the specified server. It also supports streamming.
+proxy_all = "localhost:1967"
+# redirect is optional
+redirect = { "/redirect" = "/", "/newdomain" = "gemini://example.net" }
+```
+
+## Liens utiles
+
++ Site web : [git.sr.ht/~int80h/gemserv](https://git.sr.ht/~int80h/gemserv)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/gemserv](https://github.com/YunoHost-Apps/gemserv_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/gemserv/issues](https://github.com/YunoHost-Apps/gemserv_ynh/issues)

pages/04.applications/10.docs/gemserv/app_gemserv.md

@@ -0,0 +1,60 @@
+---
+title: Gemserv
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_gemserv'
+---
+
+[![Installer Gemserv with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=gemserv) [![Integration level](https://dash.yunohost.org/integration/gemserv.svg)](https://dash.yunohost.org/appci/app/gemserv)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Gemserv* is a Gemini server written in Rust.
+
+### Disclaimers / important information
+
+Please note that Gemserv uses the TCP port 1965, so you can't use it for anything else.
+
+To add a Gemini capsule, create a `/etc/gemserv/config.d/example.toml` file as following:
+
+```
+[[server]]
+hostname = "yourdomain.org"
+dir = "/opt/yunohost/gemserv"
+key = "/etc/yunohost/certs/yourdomain.org/key.pem"
+cert = "/etc/yunohost/certs/yourdomain.org/crt.pem"
+# index is optional but defaults to index.gemini. The server will serve files
+# ending in gemini or gmi.
+index = "index.gmi"
+# lang is optional
+lang = "en"
+# cgi is optional bool
+cgi = true
+# cgipath is optional and only checked if cgi is true. It restricts cgi to only
+# this directory.
+cgipath = "/path/to/cgi-bin/"
+# scgi is optional
+scgi = { "/scgi" = "localhost:4000" }
+# cgienv is optional
+cgienv = { "GIT_PROJECT_ROOT" = "/srv/git" }
+# usrdir is optional. it'll look in each user's ~/public_gemini
+usrdir = true
+# proxy is optional
+# path is what comes after the hostname e.g. example.com/path
+proxy = { path = "localhost:1966" }
+# proxy_all is optional
+# It will send all requests to the specified server. It also supports streamming.
+proxy_all = "localhost:1967"
+# redirect is optional
+redirect = { "/redirect" = "/", "/newdomain" = "gemini://example.net" }
+```
+
+## Useful links
+
++ Website: [git.sr.ht/~int80h/gemserv](https://git.sr.ht/~int80h/gemserv)
++ Application software repository: [github.com - YunoHost-Apps/gemserv](https://github.com/YunoHost-Apps/gemserv_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/gemserv/issues](https://github.com/YunoHost-Apps/gemserv_ynh/issues)

pages/04.applications/10.docs/ghost/app_ghost.fr.md

@@ -0,0 +1,51 @@
+---
+title: Ghost
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_ghost'
+---
+
+[![Installer Ghost avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=ghost) [![Integration level](https://dash.yunohost.org/integration/ghost.svg)](https://dash.yunohost.org/appci/app/ghost)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Ghost* est une plateforme d'édition, d'adhésions, d'abonnements et de newsletters.
+
+### Avertissements / informations importantes
+
+#### Installation
+
+1. Pas de prise en charge LDAP.
+
+2. Vous avez besoin de plus de 1 Go de RAM. Si vous ne l'avez pas, veuillez créer une mémoire swap.
+
+```
+dd if=/dev/zero of=/swapfile bs=1024 count=1048576
+mkswap /fichier d'échange
+swapon / fichier d'échange
+echo "/swapfile swap swap defaults 0 0" >> /etc/fstab
+```
+
+3. Cette application est multi-instance (vous pouvez avoir plusieurs sites Web de blogs Ghost sur un seul serveur YunoHost)
+
+##### Installation de l'application Ghost
+
+0. Remarque - Lorsque vous rendez l'installation publique, vous devez accéder à votre lien de domaine Ghost SANS vous connecter à votre session YunoHost. Il est recommandé d'utiliser un mode incognito pour vous connecter à votre compte administrateur Ghost. Si vous rendez votre installation publique et essayez de vous connecter à votre compte administrateur Ghost tout en étant connecté à votre session YunoHost, vous obtiendrez une erreur d'en-tête autorisée. La raison en est que Ghost a une fonctionnalité qui permet un accès au contenu basé sur un abonnement. Cela signifie que Ghost permet à l'utilisateur administrateur de configurer d'autres utilisateurs (soit d'autres membres du personnel, soit des abonnés payés/non payés) pour avoir la possibilité de se connecter en dehors de YunoHost.
+
+1. ** L'application peut être installée par l'interface d'administration YunoHost ou par la commande suivante : **
+
+```
+sudo yunohost app install https://github.com/YunoHost-Apps/ghost_ynh
+```
+
+2. Après l'installation, créez un compte administrateur en visitant `https://domain.tld/ghost/ghost`. Si vous choisissez de nommer votre instance Ghost "blog" pendant le processus d'installation de YunoHost, alors ce sera "https://domain.tld/blog/ghost". Cela vous permettra de continuer à configurer votre compte administrateur et à configurer vos paramètres.
+
+## Liens utiles
+
++ Site web : [ghost.org](https://ghost.org/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/ghost](https://github.com/YunoHost-Apps/ghost_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/ghost/issues](https://github.com/YunoHost-Apps/ghost_ynh/issues)

pages/04.applications/10.docs/ghost/app_ghost.md

@@ -0,0 +1,51 @@
+---
+title: Ghost
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_ghost'
+---
+
+[![Installer Ghost with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=ghost) [![Integration level](https://dash.yunohost.org/integration/ghost.svg)](https://dash.yunohost.org/appci/app/ghost)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Ghost* is a publishing, memberships, subscriptions and newsletters platform.
+
+### Disclaimers / important information
+
+#### Installation
+
+1. No LDAP support.
+
+2. You need more than 1GB of ram. If you don't have it, please create a swap memory.
+
+```
+dd if=/dev/zero of=/swapfile bs=1024 count=1048576
+mkswap /swapfile
+swapon /swapfile
+echo "/swapfile swap swap defaults 0 0" >> /etc/fstab
+```
+
+3. This app is multi-instance (you can have more than one Ghost blogging websites on a single YunoHost server)
+
+##### Installing the Ghost app
+
+0. Note - When making the install public, your Ghost domain link must be accessed WHILE NOT signed into your YunoHost session. It is recommended to use a incognito mode to sign into your Ghost admin account. If you make your install public, and try to login your Ghost admin account while signed into your YunoHost session, you will get a an authorized header error. The reason for this is because Ghost has a feature that allows for a subscription based access for content. This means Ghost allows for the admin user to setup other users (either other staff or paid/unpaid subscribers) to have the abilility to login outside of YunoHost.
+
+1. App can be installed by YunoHost admin interface or by the following command:
+
+```
+sudo yunohost app install https://github.com/YunoHost-Apps/ghost_ynh
+```
+
+2. After installation create an admin account by visiting `https://domain.tld/ghost/ghost`. If you choose to name your Ghost instance "blog" during YunoHost setup process, then it would be https://domain.tld/blog/ghost. This will allow you to continue to setup your admin account and configure your settings.
+
+## Useful links
+
++ Website: [ghost.org](https://ghost.org/)
++ Application software repository: [github.com - YunoHost-Apps/ghost](https://github.com/YunoHost-Apps/ghost_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/ghost/issues](https://github.com/YunoHost-Apps/ghost_ynh/issues)

pages/04.applications/10.docs/grafana/app_grafana.fr.md

@@ -0,0 +1,55 @@
+---
+title: Grafana
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_grafana'
+---
+
+[![Installer Grafana avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=grafana) [![Integration level](https://dash.yunohost.org/integration/grafana.svg)](https://dash.yunohost.org/appci/app/grafana)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Grafana* est un tableaux de bord de supervision.
+
+### Captures d'écran
+
+![Capture d'écran de Grafana](https://github.com/YunoHost-Apps/grafana_ynh/blob/master/doc/screenshots/Grafana8_Kubernetes.jpg)
+
+### Avertissements / informations importantes
+
+#### Configuration
+
+**Important lors de la première connexion :**
+
+* vous devez aller dans le menu Grafana (icône Grafana), sélectionner le menu de votre compte et sélectionner Switch to Main Org.
+* vous pouvez maintenant accéder au tableau de bord NetData par défaut via le menu Accueil
+
+**N'hésitez pas à créer de nouveaux tableaux de bord** : le tableau de bord par défaut contient des métriques de NetData, mais uniquement des métriques génériques qui sont générées sur chaque machine. NetData détecte dynamiquement les services et applications (par exemple Redis, NGINX, etc.) et enrichit son tableau de bord et les métriques générées. De nombreuses métriques NetData n'apparaissent pas dans le tableau de bord Grafana fourni par défaut !
+
+### Caractéristiques spécifiques à YunoHost
+
+* installe InfluxDB comme base de données de séries chronologiques
+* si le paquet NetData est installé, il est configuré pour qu'il alimente InfluxDB toutes les minutes
+* installe Grafana comme serveur de tableaux de bord
+* crée une source de données Grafana pour récupérer les données d'InfluxDB (et donc de NetData !)
+* crée un tableau de bord par défaut pour tracer certaines données de NetData (il ne couvre pas toutes les métriques, il peut être considérablement amélioré !)
+
+**Architecture générale**
+
+![image](https://cloud.githubusercontent.com/assets/2662304/20649711/29f182ba-b4ce-11e6-97c8-ab2c0ab59833.png)
+
+#### Limitations
+
+* Le tableau de bord par défaut peut être mis à jour dans une prochaine version de ce paquet, alors assurez-vous de créer vos propres tableaux de bord !
+* La création d'organisations ne fonctionne pas bien avec l'intégration LDAP ; elle est désactivée pour les utilisateurs standard, mais ne peut pas être désactivée pour les administrateurs : **veuillez ne pas créer d'organisations !**
+
+## Liens utiles
+
++ Site web : [grafana.com](https://grafana.com/)
++ Démonstration : [Démo](https://demo.grafana.eu/login)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/grafana](https://github.com/YunoHost-Apps/grafana_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/grafana/issues](https://github.com/YunoHost-Apps/grafana_ynh/issues)

pages/04.applications/10.docs/grafana/app_grafana.md

@@ -0,0 +1,55 @@
+---
+title: Grafana
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_grafana'
+---
+
+[![Installer Grafana with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=grafana) [![Integration level](https://dash.yunohost.org/integration/grafana.svg)](https://dash.yunohost.org/appci/app/grafana)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Grafana* is a metric & analytic dashboards for monitoring.
+
+### Screenshots
+
+![Screenshots Grafana](https://github.com/YunoHost-Apps/grafana_ynh/blob/master/doc/screenshots/Grafana8_Kubernetes.jpg)
+
+### Avertissements / informations importantes
+
+#### Configuration
+
+**Important at first login:**
+
+* you have to go the Grafana Menu (Grafana icon), select your account menu and select Switch to Main Org.
+* you can now access the default NetData dashboard via the Home menu
+
+**Don't hesitate to create new dashboards**: the default dashboard contains metrics from NetData, but only generic ones that are generated on every machine. NetData dynamically detects services and applications (e.g. Redis, NGINX, etc.) and enriches its dashboard and generated metrics. Many NetData metrics don't appear in the provided default Grafana dashboard!
+
+### YunoHost specific features
+
+* installs InfluxDB as time series database
+* if the NetData package is installed, configures NetData to feed InfluxDB every minute
+* installs Grafana as dashboard server
+* creates a Grafana Data Source to fetch data from InfluxDB (and hence NetData!)
+* creates a default dashboard to plot some data from NetData (doesn't cover every metric, can be greatly enhanced!)
+
+**General architecture**
+
+![image](https://cloud.githubusercontent.com/assets/2662304/20649711/29f182ba-b4ce-11e6-97c8-ab2c0ab59833.png)
+
+#### Limitations
+
+* The default dashboard may be updated in a further release of this package, so please make sure you create your own dashboards!
+* Organizations creation doesn't play well with LDAP integration; it is disabled for standard users, but can't be disabled for administrators: **please do not create organizations!**
+
+## Useful links
+
++ Website: [grafana.com](https://grafana.com/)
++ Demonstration: [Demo](https://play.grafana.org/)
++ Application software repository: [github.com - YunoHost-Apps/grafana](https://github.com/YunoHost-Apps/grafana_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/grafana/issues](https://github.com/YunoHost-Apps/grafana_ynh/issues)

pages/04.applications/10.docs/guacamole/app_guacamole.fr.md

@@ -0,0 +1,32 @@
+---
+title: Guacamole
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_guacamole'
+---
+
+[![Installer Guacamole avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=guacamole) [![Integration level](https://dash.yunohost.org/integration/guacamole.svg)](https://dash.yunohost.org/appci/app/guacamole)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Guacamole* est un service de bureau à distance sans client. Fonctionne avec des protocoles standard comme VNC, RDP, et SSH.
+
+### Captures d'écran
+
+![Capture d'écran de Guacamole](https://github.com/YunoHost-Apps/guacamole_ynh/blob/master/doc/screenshots/screenshot1.jpg)
+
+### Avertissements / informations importantes
+
+#### Configuration
+
+L'utilisateur choisi comme admin durant le processus d'installation aura accès au paramétres d'administration dans le menu de configuration de l'application (sous le menu utilisateur). Le fichiers de configuration sont dans `/opt/yunohost/guacamole/etc/guacamole` (pour la première installation).
+
+## Liens utiles
+
++ Site web : [guacamole.apache.org](https://guacamole.apache.org/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/guacamole](https://github.com/YunoHost-Apps/guacamole_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/guacamole/issues](https://github.com/YunoHost-Apps/guacamole_ynh/issues)

pages/04.applications/10.docs/guacamole/app_guacamole.md

@@ -0,0 +1,32 @@
+---
+title: Guacamole
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_guacamole'
+---
+
+[![Installer Guacamole with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=guacamole) [![Integration level](https://dash.yunohost.org/integration/guacamole.svg)](https://dash.yunohost.org/appci/app/guacamole)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Guacamole* is a clientless remote desktop gateway. It supports standard protocols like VNC, RDP, and SSH.
+
+### Screenshots
+
+![Screenshots Guacamole](https://github.com/YunoHost-Apps/guacamole_ynh/blob/master/doc/screenshots/screenshot1.jpg)
+
+### Disclaimers / important information
+
+#### Configuration
+
+The user that is configured as admin during install will have access to admin settings in the settings menu of the app (under the user menu). Configuration files are in `/opt/yunohost/guacamole/etc/guacamole` (for the first install).
+
+## Useful links
+
++ Website: [guacamole.apache.org](https://guacamole.apache.org/)
++ Application software repository: [github.com - YunoHost-Apps/guacamole](https://github.com/YunoHost-Apps/guacamole_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/guacamole/issues](https://github.com/YunoHost-Apps/guacamole_ynh/issues)

pages/04.applications/10.docs/h5ai/app_h5ai.fr.md

@@ -0,0 +1,30 @@
+---
+title: h5ai
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_h5ai'
+---
+
+[![Installer h5ai avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=h5ai) [![Integration level](https://dash.yunohost.org/integration/h5ai.svg)](https://dash.yunohost.org/appci/app/h5ai)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*h5ai* est un serveur moderne d'index pour NGINX.
+
+### Avertissements / informations importantes
+
+#### Configuration
+
+Après avoir installé l'application, vous pouvez ajouter des documents dans `/var/www/documents` (ou le chemin correspondant que vous avez choisi).
+h5ai ne permet pas de modifier ou de télécharger de nouveaux documents directement à partir du navigateur Web. Vous pouvez imaginer coupler le dossier `/var/www/documents` à Nextcloud ou un FTP pour permettre à certains utilisateurs de télécharger du contenu et d'utiliser h5ai comme interface publique en lecture seule.
+Le fichier de configuration principal est `_h5ai/private/conf/options.json`. Vous souhaiterez peut-être modifier certains des paramètres documentés. Mais il y a d'autres fichiers dans `_h5ai/private/conf` que vous pourriez consulter.
+
+## Liens utiles
+
++ Site web : [larsjung.de/h5ai](https://larsjung.de/h5ai/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/h5ai](https://github.com/YunoHost-Apps/h5ai_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/h5ai/issues](https://github.com/YunoHost-Apps/h5ai_ynh/issues)

pages/04.applications/10.docs/h5ai/app_h5ai.md

@@ -0,0 +1,30 @@
+---
+title: h5ai
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_h5ai'
+---
+
+[![Installer h5ai with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=h5ai) [![Integration level](https://dash.yunohost.org/integration/h5ai.svg)](https://dash.yunohost.org/appci/app/h5ai)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*h5ai* is a modern HTTP web server index for NGINX.
+
+### Disclaimers / important information
+
+#### Configuration
+
+After installing the application, you can add documents in `/var/www/documents` (or the corresponding path you choosed).
+h5ai doesn't allow to edit or upload new documents directly from the web browser. But you can imagine coupling the folder `/var/www/documents` to Nextcloud or some sort of FTP to allow some users to upload content, and use h5ai as a public read-only interface.
+The main configuration file is `_h5ai/private/conf/options.json`. You might want to change some of the documented settings. But there are some more files in `_h5ai/private/conf` you might have a look at.
+
+## Useful links
+
++ Website: [larsjung.de/h5ai](https://larsjung.de/h5ai/)
++ Application software repository: [github.com - YunoHost-Apps/h5ai](https://github.com/YunoHost-Apps/h5ai_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/h5ai/issues](https://github.com/YunoHost-Apps/h5ai_ynh/issues)

pages/04.applications/10.docs/homeassistant/app_homeassistant.fr.md

@@ -0,0 +1,34 @@
+---
+title: Home Assistant
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_homeassistant'
+---
+
+[![Installer Home Assistant avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=homeassistant) [![Integration level](https://dash.yunohost.org/integration/homeassistant.svg)](https://dash.yunohost.org/appci/app/homeassistant)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Home Assistant* est une plateforme domotique.
+
+### Avertissements / informations importantes
+
+* Limitations connues :
+    * Les authentifications LDAP et HTTP sont-elles prises en charge ? LDAP=Oui | HTTP auth=Non
+    * L'application peut-elle être utilisée par plusieurs utilisateurs ? Oui
+
+* Informations complémentaires :
+    * Comme la version de Pyhton fournie dans la version stable de Debian n'est pas toujours prise en charge, une version récente peut être construite pendant le processus d'installation. Cela peut prendre un certain temps (15 à 60 minutes).
+
+
+
+## Liens utiles
+
++ Site web : [homeassistant.eu (fr)](https://homeassistant.eu/site/fr/)
++ Démonstration : [Démo](https://demo.home-assistant.io/#/lovelace/0)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/homeassistant](https://github.com/YunoHost-Apps/homeassistant_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/homeassistant/issues](https://github.com/YunoHost-Apps/homeassistant_ynh/issues)

pages/04.applications/10.docs/homeassistant/app_homeassistant.md

@@ -0,0 +1,32 @@
+---
+title: Home Assistant
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_homeassistant'
+---
+
+[![Installer Home Assistant with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=homeassistant) [![Integration level](https://dash.yunohost.org/integration/homeassistant.svg)](https://dash.yunohost.org/appci/app/homeassistant)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Home Assistant* is a home automation platform.
+
+### Disclaimers / important information
+
+* Known limitations:
+    * Are LDAP and HTTP auth supported? LDAP=Yes | HTTP auth=No
+    * Can the app be used by multiple users? Yes
+
+* Additional informations:
+    * As the pyhton version shipped in Debian stable is not always supported, a recent version could be built during the installation process. It may take a while to achive that (15 to 60 minutes)
+
+## Useful links
+
++ Website: [homeassistant.eu (en)](https://homeassistant.eu/site/)
++ Demonstration: [Demo](https://demo.home-assistant.io/#/lovelace/0)
++ Application software repository: [github.com - YunoHost-Apps/homeassistant](https://github.com/YunoHost-Apps/homeassistant_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/homeassistant/issues](https://github.com/YunoHost-Apps/homeassistant_ynh/issues)

pages/04.applications/10.docs/ifm/app_ifm.fr.md

@@ -0,0 +1,27 @@
+---
+title: IFM
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_ifm'
+---
+
+[![Installer IFM avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=ifm) [![Integration level](https://dash.yunohost.org/integration/ifm.svg)](https://dash.yunohost.org/appci/app/ifm)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*IFM* est un gestionnaire de fichiers basé sur le Web, qui se présente sous la forme d'un fichier unique utilisant HTML5, CSS3, JavaScript et PHP.
+
+### Avertissements / informations importantes
+
+L'IFM est généralement verrouillé dans son propre répertoire (`/home/yunohost.app/ifm`), vous ne pouvez donc pas aller sur d'autres répertoires. Vous pouvez changer cela en définissant `env[IFM_ROOT_DIR] = /home/yunohost.app/ifm` dans la configuration PHP `/etc/php/7.3/fpm/pool.d/ifm.conf` L.434 en vous aidant de cette [documentation](https://github.com/misterunknown/ifm/wiki/Configuration). 
+
+## Liens utiles
+
++ Site web : [github.com/misterunknown/ifm](https://github.com/misterunknown/ifm)
++ Démonstration : [Démo](https://ifmdemo.gitea.de/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/ifm](https://github.com/YunoHost-Apps/ifm_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/ifm/issues](https://github.com/YunoHost-Apps/ifm_ynh/issues)

pages/04.applications/10.docs/ifm/app_ifm.md

@@ -0,0 +1,27 @@
+---
+title: IFM
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_ifm'
+---
+
+[![Installer IFM with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=ifm) [![Integration level](https://dash.yunohost.org/integration/ifm.svg)](https://dash.yunohost.org/appci/app/ifm)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*IFM* is a web-based filemanager, which comes as a single file solution using HTML5, CSS3, JavaScript and PHP.
+
+### Disclaimers / important information
+
+The IFM is usually locked to it's own directory (`/home/yunohost.app/ifm`), so you are not able to go above. You can change that by setting `env[IFM_ROOT_DIR] = /home/yunohost.app/ifm` in the PHP config `/etc/php/7.3/fpm/pool.d/ifm.conf` L.434 with the help of this [documentation](https://github.com/misterunknown/ifm/wiki/Configuration).
+
+## Useful links
+
++ Website: [github.com/misterunknown/ifm](https://github.com/misterunknown/ifm)
++ Demonstration: [Demo](https://ifmdemo.gitea.de/)
++ Application software repository: [github.com - YunoHost-Apps/ifm](https://github.com/YunoHost-Apps/ifm_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/ifm/issues](https://github.com/YunoHost-Apps/ifm_ynh/issues)

pages/04.applications/10.docs/ihatemoney/app_ihatemoney.fr.md

@@ -0,0 +1,43 @@
+---
+title: I Hate Money
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_ihatemoney'
+---
+
+[![Installer I Hate Money avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=ihatemoney) [![Integration level](https://dash.yunohost.org/integration/ihatemoney.svg)](https://dash.yunohost.org/appci/app/ihatemoney)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*I Hate Money* est une application web conçue pour faciliter la gestion partagée du budget. Elle permet de savoir qui a acheté quoi, quand et pour qui, et aide à régler les factures.
+
+### Captures d'écran
+
+![Capture d'écran de I Hate Money](https://github.com/YunoHost-Apps/ihatemoney_ynh/blob/master/doc/screenshots/screenshot_1_global.webp)
+![Capture d'écran de I Hate Money](https://github.com/YunoHost-Apps/ihatemoney_ynh/raw/master/doc/screenshots/screenshot_2_new_operation.webp)
+
+### Avertissements / informations importantes
+
+* L'authentification LDAP et login unifié (SSO) n'est pas supportée. Le mécanisme de connexion sur IHateMoney se fait par projet et ne peut donc pas être intégrée dans YunoHost
+
+- **app non publique**:
+  - authentification YunoHost requise
+  - identifiants de projets requis
+  - Tout utilisateur YunoHost avec accès à l'app peut créer un nouveau projet.
+- **app publique** :
+  - authentification YunoHost non requise
+  - identifiants de projets requis
+  - Tout visiteur peut créer un nouveau projet.
+
+* Lors de la mise à jour de la version 4.1.5~ynh3, un nouveau mot de passe administrateur est généré et envoyé à root.
+
+## Liens utiles
+
++ Site web : [github.com/spiral-project/ihatemoney](https://github.com/spiral-project/ihatemoney)
++ Démonstration : [Démo](https://ihatemoney.org/authenticate?project_id=demo)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/ihatemoney](https://github.com/YunoHost-Apps/ihatemoney_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/ihatemoney/issues](https://github.com/YunoHost-Apps/ihatemoney_ynh/issues)

pages/04.applications/10.docs/ihatemoney/app_ihatemoney.md

@@ -0,0 +1,43 @@
+---
+title: I Hate Money
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_ihatemoney'
+---
+
+[![Installer I Hate Money with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=ihatemoney) [![Integration level](https://dash.yunohost.org/integration/ihatemoney.svg)](https://dash.yunohost.org/appci/app/ihatemoney)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*I Hate Money* is a web application made to ease shared budget management. It keeps track of who bought what, when, and for whom; and helps to settle the bills.
+
+### Screenshots
+
+![Screenshots I Hate Money](https://github.com/YunoHost-Apps/ihatemoney_ynh/blob/master/doc/screenshots/screenshot_1_global.webp)
+![Screenshots I Hate Money](https://github.com/YunoHost-Apps/ihatemoney_ynh/raw/master/doc/screenshots/screenshot_2_new_operation.webp)
+
+### Disclaimers / important information
+
+* LDAP authentication and Single Sign-on is not supported. The login mechanism in IHateMoney is per-project (not per-user) and therefore can't be integrated in YunoHost.
+
+- **non-public app**:
+  - YunoHost login required
+  - per-project identifiers required
+  - any YunoHost user with access to the app can create a new project.
+- **public app**:
+  - no YunoHost login required
+  - per-project identifiers required
+  - any visitor can create a new project.
+
+* During upgrade from version 4.1.5~ynh3, a new admin password is generated and sent to the root
+
+## Useful links
+
++ Website: [github.com/spiral-project/ihatemoney](https://github.com/spiral-project/ihatemoney)
++ Demonstration: [Demo](https://ihatemoney.org/authenticate?project_id=demo)
++ Application software repository: [github.com - YunoHost-Apps/ihatemoney](https://github.com/YunoHost-Apps/ihatemoney_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/ihatemoney/issues](https://github.com/YunoHost-Apps/ihatemoney_ynh/issues)

pages/04.applications/10.docs/kimai2/app_kimai2.fr.md

@@ -0,0 +1,40 @@
+---
+title: Kimai2
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_kimai2'
+---
+
+[![Installer Kimai2 avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=kimai2) [![Integration level](https://dash.yunohost.org/integration/kimai2.svg)](https://dash.yunohost.org/appci/app/kimai2)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Kimai2* est la version actualisée du timetracker open source Kimai. Actuellement, il est dans une phase de développement précoce, il est utilisable mais certaines fonctionnalités avancées de Kimai v1 sont manquantes.
+
+Kimai v2 n'a rien en commun avec son prédécesseur Kimai v1 à part les idées de base du suivi du temps et l'équipe de développement actuelle.
+
+### Avertissements / informations importantes
+
+* Il faut un domaine dédié comme **kimai.domain.tld**.
+* Cette application est multi-instance (vous pouvez avoir plus d'une instance Kimai sur un serveur YunoHost).
+* Comme le support de SQLite s'est arrêté à la version 1.14, si vous avez choisi une base de données SQLite pendant l'installation, la mise à jour de Kimai2 est bloquée à la version 1.13.
+
+#### Support multi-utilisateurs
+
+LDAP est supporté HTTP auth n'est pas supporté Les rôles par défaut de Kimai2 sont :
+* ROLE_USER
+* ROLE_TEAMLEAD => Kimai2 (Teamlead) YunoHost permission
+* ROLE_ADMIN => Kimai2 (Admin) YunoHost permission
+* ROLE_SUPER_ADMIN => Kimai2 (Super_Admin) YunoHost permission
+Those roles are directly managed using YunoHost permission system. User choosen during installation is granted the ROLE_SUPER_ADMIN
+
+## Liens utiles
+
++ Site web : [kimai.org](https://www.kimai.org/)
++ Démonstration : [Démo](https://www.kimai.org/demo/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/kimai2](https://github.com/YunoHost-Apps/kimai2_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/kimai2/issues](https://github.com/YunoHost-Apps/kimai2_ynh/issues)

pages/04.applications/10.docs/kimai2/app_kimai2.md

@@ -0,0 +1,41 @@
+---
+title: Kimai2
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_kimai2'
+---
+
+[![Installer Kimai2 with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=kimai2) [![Integration level](https://dash.yunohost.org/integration/kimai2.svg)](https://dash.yunohost.org/appci/app/kimai2)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Kimai2* is the reloaded version of the open source timetracker Kimai. Right now its in an early development phase, its usable but some advanced features from Kimai v1 are missing by now.
+
+Kimai v2 has nothing in common with its predecessor Kimai v1 besides the basic ideas of time-tracking and the current development team.
+
+### Disclaimers / important information
+
+* Require dedicated domain like **kimai.domain.tld**.
+* This app is multi-instance (you can have more then one Kimai instance running on a YunoHost server)
+* As sqlite support ended on version 1.14, if you choosed an sqlite databse during installation, Kimai2 upgrade is blocked to version 1.13
+
+#### Multi-user support
+
+LDAP is supported HTTP auth is not supported Defaul Kimai2 roles are:
+* ROLE_USER
+* ROLE_TEAMLEAD => Kimai2 (Teamlead) YunoHost permission
+* ROLE_ADMIN => Kimai2 (Admin) YunoHost permission
+* ROLE_SUPER_ADMIN => Kimai2 (Super_Admin) YunoHost permission
+Those roles are directly managed using YunoHost permission system. User choosen during installation is granted the ROLE_SUPER_ADMIN
+
+
+## Useful links
+
++ Website: [kimai.org](https://www.kimai.org/)
++ Demonstration: [Demo](https://www.kimai.org/demo/)
++ Application software repository: [github.com - YunoHost-Apps/kimai2](https://github.com/YunoHost-Apps/kimai2_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/kimai2/issues](https://github.com/YunoHost-Apps/kimai2_ynh/issues)

pages/04.applications/10.docs/kiwiirc/app_kiwiirc.fr.md

@@ -0,0 +1,27 @@
+---
+title: KiwiIRC
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_kiwiirc'
+---
+
+[![Installer KiwiIRC avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=kiwiirc) [![Integration level](https://dash.yunohost.org/integration/kiwiirc.svg)](https://dash.yunohost.org/appci/app/kiwiirc)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*KiwiIRC* est un système de messagerie polyvalent basé sur le web et utilisant IRC.
+
+### Captures d'écran
+
+![Capture d'écran de KiwiIRC](https://github.com/YunoHost-Apps/kiwiirc_ynh/blob/master/doc/screenshots/screenshot.png)
+
+## Liens utiles
+
++ Site web : [kiwiirc.com](https://kiwiirc.com/)
++ Démonstration : [Démo](https://kiwiirc.com/nextclient/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/kiwiirc](https://github.com/YunoHost-Apps/kiwiirc_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/kiwiirc/issues](https://github.com/YunoHost-Apps/kiwiirc_ynh/issues)

pages/04.applications/10.docs/kiwiirc/app_kiwiirc.md

@@ -0,0 +1,27 @@
+---
+title: KiwiIRC
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_kiwiirc'
+---
+
+[![Installer KiwiIRC with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=kiwiirc) [![Integration level](https://dash.yunohost.org/integration/kiwiirc.svg)](https://dash.yunohost.org/appci/app/kiwiirc)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*KiwiIRC* is a versatile web based messenger using IRC.
+
+### Screenshots
+
+![Screenshots KiwiIRC](https://github.com/YunoHost-Apps/kiwiirc_ynh/blob/master/doc/screenshots/screenshot.png)
+
+## Useful links
+
++ Website: [kiwiirc.com](https://kiwiirc.com/)
++ Demonstration: [Demo](https://kiwiirc.com/nextclient/)
++ Application software repository: [github.com - YunoHost-Apps/kiwiirc](https://github.com/YunoHost-Apps/kiwiirc_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/kiwiirc/issues](https://github.com/YunoHost-Apps/kiwiirc_ynh/issues)

pages/04.applications/10.docs/komga/app_komga.fr.md

@@ -0,0 +1,27 @@
+---
+title: Komga
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_komga'
+---
+
+[![Installer Komga avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=komga) [![Integration level](https://dash.yunohost.org/integration/komga.svg)](https://dash.yunohost.org/appci/app/komga)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Komga* est un serveur de bandes dessinées/mangas gratuit et open source.
+
+### Captures d'écran
+
+![Capture d'écran de Komga](https://github.com/YunoHost-Apps/komga_ynh/blob/master/doc/screenshots/home.png)
+
+## Liens utiles
+
++ Site web : [komga.org](https://komga.org/)
++ Démonstration : [Démo](https://demo.komga.org)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/komga](https://github.com/YunoHost-Apps/komga_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/komga/issues](https://github.com/YunoHost-Apps/komga_ynh/issues)

pages/04.applications/10.docs/komga/app_komga.md

@@ -0,0 +1,27 @@
+---
+title: Komga
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_komga'
+---
+
+[![Installer Komga with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=komga) [![Integration level](https://dash.yunohost.org/integration/komga.svg)](https://dash.yunohost.org/appci/app/komga)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Komga* is a free and open source comics/mangas server.
+
+### Screenshots
+
+![Screenshots Komga](https://github.com/YunoHost-Apps/komga_ynh/blob/master/doc/screenshots/home.png)
+
+## Useful links
+
++ Website: [komga.org](https://komga.org/)
++ Demonstration: [Demo](https://demo.komga.org)
++ Application software repository: [github.com - YunoHost-Apps/komga](https://github.com/YunoHost-Apps/komga_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/komga/issues](https://github.com/YunoHost-Apps/komga_ynh/issues)

pages/04.applications/10.docs/mailman3/app_mailman3.fr.md

@@ -0,0 +1,71 @@
+---
+title: Mailman3
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_mailman3'
+---
+
+[![Installer Mailman3 avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=mailman3) [![Integration level](https://dash.yunohost.org/integration/mailman3.svg)](https://dash.yunohost.org/appci/app/mailman3)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+*Mailman3* est un gestionnaire de liste de discussion par email.
+
+## Captures d'écran
+
+![Capture d'écran de Mailman3](https://github.com/YunoHost-Apps/mailman3_ynh/blob/master/doc/screenshots/screenshot1.webp)
+
+## Avertissements / informations importantes
+
+* Toutes les limitations, contraintes ou choses connues qui ne fonctionnent pas, telles que (mais pas limitées à) :
+    * nécessitant un domaine dédié complet
+
+* Autres informations que les gens devraient connaître, telles que :
+    * Il n'y a pas encore de support LDAP (apparemment en cours de développement).
+    * Les utilisateurs peuvent également s'inscrire eux-mêmes pour gérer les détails.
+    * Les utilisateurs peuvent utiliser les listes de diffusion sans s'inscrire ?
+
+L'administration classique est disponible sur la page : https://myyunohost.org/
+
+L'admin Django est disponible sur la page : https://myyunohost.org/admin/
+
+## Configuration générale
+
+Mailman 3 ou "The Mailman Suite" est composé de 5 parties mobiles. Pour en savoir plus, consultez la documentation suivante :
+
+> http://docs.mailman3.org/en/latest/index.html#the-mailman-suite
+
+Sur votre YunoHost, tous les fichiers de configuration dont vous devez vous soucier se trouvent dans :
+
+* `/etc/mailman3/`
+* `/usr/share/mailman3-web/`
+
+Les services que vous devez gérer peuvent être vérifiés avec :
+
+* `systemctl status mailman3`
+* `systemctl status mailman3-web`
+
+Il est important de noter que ce paquet utilise le paquet Debian [mailman3-full](http://docs.mailman3.org/en/latest/prodsetup.html#distribution-packages) contenu dans le dépôt des rétro-portages (backports) de Debian Stretch. L'installation par défaut suppose l'utilisation d'une base de données SQLite3, mais le script d'installation passe outre et utilise une base de données PostgreSQL à la place.
+
+Enfin, vous pouvez également configurer les choses via l'administration web de Django disponible à `/admin/`
+
+## Limitations
+
+* La migration à partir de Mailman 2.X n'est pas officiellement supportée, désolé. Cependant, il existe un manuel qui détaille un processus expérimental. Veuillez consulter [la documentation] (https://docs.mailman3.org/en/latest/migration.html).
+
+* Mailman3 doit être configuré pour utiliser un domaine principal (https://myyunohost.org et non https://myyunohost.org/mailman3).
+
+* Vous devez avoir un certificat HTTPS installé sur le domaine racine.
+
+* Il ne peut y avoir qu'une seule installation par YunoHost.
+
+## Liens utiles
+
++ Site web : [list.org](https://www.list.org/)
++ Démonstration : [Démo](https://lists.mailman3.org/mailman3/lists/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/mailman3](https://github.com/YunoHost-Apps/mailman3_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/mailman3/issues](https://github.com/YunoHost-Apps/mailman3_ynh/issues)

pages/04.applications/10.docs/mailman3/app_mailman3.md

@@ -0,0 +1,72 @@
+---
+title: Mailman3
+template: docs
+taxonomy:
+    category: docs, apps
+routes:
+  default: '/app_mailman3'
+---
+
+[![Installer Mailman3 with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=mailman3) [![Integration level](https://dash.yunohost.org/integration/mailman3.svg)](https://dash.yunohost.org/appci/app/mailman3)
+
+### Index
+
+- [Useful links](#useful-links)
+
+*Mailman3* is an electronic mailing lists manager.
+
+### Screenshots
+
+![Screenshot of Mailman3](./doc/screenshots/screenshot1.webp)
+
+### Disclaimers / important information
+
+* Any known limitations, constrains or stuff not working, such as (but not limited to):
+    * requiring a full dedicated domain
+
+* Other infos that people should be aware of, such as:
+    * No LDAP support yet (apparently under development)
+    * Users can also just sign up themselves to manage details
+    * Users can use mailing lists without signing up?
+
+Classical admin is available on the page: https://myyunohost.org/
+
+Django admin on: https://myyunohost.org/admin/
+
+### General Configuration
+
+Mailman 3 or "The Mailman Suite" is made up of 5 moving parts. See the following documentation for more:
+
+> http://docs.mailman3.org/en/latest/index.html#the-mailman-suite
+
+On your YunoHost, all the configuration files you need to worry about are in:
+
+* `/etc/mailman3/`
+* `/usr/share/mailman3-web/`
+
+The services you need to manage can be checked with:
+
+* `systemctl status mailman3`
+* `systemctl status mailman3-web`
+
+It is important to note that this package makes use of the [mailman3-full](http://docs.mailman3.org/en/latest/prodsetup.html#distribution-packages) Debian package contained in the Debian Stretch backports repository. The default installation assumes the use of a SQLite3 database but the installation script overrides this and uses a PostgreSQL database instead.
+
+Finally, you also configure things through the Django web admin available at `/admin/`.
+
+### Limitations
+
+* Migrating from Mailman 2.X is not officially supported, sorry. However, there is a manual and
+  which details an experimental process. Please see [the documentation](https://docs.mailman3.org/en/latest/migration.html).
+
+* Mailman3 must be configured to use a root domain (https://myyunohost.org and not https://myyunohost.org/mailman3).
+
+* You must have a HTTPS certificate installed on the root domain.
+
+* There may be only one installation per YunoHost.
+
+## Useful links
+
++ Website: [list.org](https://www.list.org/)
++ Demonstration: [Demo](https://lists.mailman3.org/mailman3/lists/)
++ Application software repository: [github.com - YunoHost-Apps/mailman3](https://github.com/YunoHost-Apps/mailman3_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/mailman3/issues](https://github.com/YunoHost-Apps/mailman3_ynh/issues)