@@ -17,7 +17,7 @@ Il suffit maintenant d'ajouter les redirections DNS comme indiqué dans la [conf
[Tutoriel plus général sur l’IP dynamique](dns_dynamicip_fr).
-Cette partie est à suivre que si votre IP est dynamique.
+Cette partie est à suivre, que si votre IP est dynamique.
Pour savoir si votre fournisseur d’accès internet vous fournit une IP dynamique [voir ici](/isp_fr).
diff --git a/README.md b/README.md
index 207de741..bbdcfc2b 100644
--- a/README.md
+++ b/README.md
@@ -3,5 +3,4 @@
* [Web Site](https://yunohost.org)
* Based on [Simone](https://github.com/YunoHost/Simone)
-Please report [issues on YunoHost bugtracker](https://dev.yunohost.org/projects/yunohost/issues) (no registration needed).
-
+Please report [issues on YunoHost bugtracker](https://github.com/YunoHost/issues/issues).
\ No newline at end of file
diff --git a/XMPP.md b/XMPP.md
index 3b6ccc68..dae040e2 100644
--- a/XMPP.md
+++ b/XMPP.md
@@ -2,17 +2,16 @@
XMPP is a communication protocol of instant messaging, VoIP (Voice over IP), videoconferencing.
YunoHost provide:
-* [Metronome](http://www.lightwitch.org/metronome): a XMPP server
-* [Jappix](/apps): a web XMPP client
+* [Metronome](https://metronome.im/): a XMPP server
## Desktop XMPP client
You can connect to your XMPP server with any standard desktop XMPP client, such as [Pidgin](http://pidgin.im/), [Gajim](http://gajim.org), [Jitsi](http://jitsi.org/) or [Adium](https://adium.im/).
The credentials to give are :
-* The first part of your email address (without the @domain.tld)
+* Your email address (with the @domain.tld)
* Your standard YunoHost password
Your XMPP server runs on the standard port 5222. Your administrator might need to forward this port if the server is behind a router.
-
\ No newline at end of file
+
diff --git a/XMPP_fr.md b/XMPP_fr.md
index 4e93435f..2ae2df86 100644
--- a/XMPP_fr.md
+++ b/XMPP_fr.md
@@ -2,11 +2,9 @@
Yunohost est installé avec un serveur de messagerie instantanée XMPP (metronome).
-Vous pouvez discuter simplement avec des contacts XMPP/Jabber en installant l’application [Jappix](https://jappix.com/) depuis l’interface d’administration.
-
[XMPP](https://fr.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) est un protocole ouvert et extensible qui permet également de créer des salons de discussions, de partager des statuts et des données, de passer des appels en VoIP et de faire de la visioconférence.
-Toutes les applications basées sur XMPP sont compatibles entre-elles : lorsque vous utilisez un client XMPP vous pouvez discuter avec n’importe quel possesseur.e d’un compte XMPP/Jabber. Ce protocole est déjà utilisé par des millions de personnes dans le monde.
+Toutes les applications basées sur XMPP sont compatibles entre-elles : lorsque vous utilisez un client XMPP vous pouvez discuter avec n’importe quel possesseur d’un compte XMPP/Jabber. Ce protocole est déjà utilisé par des millions de personnes dans le monde.
### Compte XMPP/Jabber
@@ -14,9 +12,9 @@ Un compte XMPP/Jabber est basé sur un identifiant sous la forme `utilisateur@do
Sous yunohost, cet identifiant correspond simplement à l’adresse courriel principale d’un utilisateur. Le mot de passe est celui du compte de l’utilisateur.
-### Utiliser un autre client XMPP
+### Se connecter à XMPP
-En plus de Jappix, il existe d’autres clients web orientés réseau social, comme [Movim](https://pod.movim.eu) ou [Libervia/Salut à Toi](http://salut-a-toi.org/).
+Il existe des clients web orientés réseau social, comme [Movim](https://pod.movim.eu) ou [Libervia/Salut à Toi](http://salut-a-toi.org/).
Vous pouvez également utiliser un client desktop comme [Pidgin](http://pidgin.im/) (multiplateforme), [Gajim](http://gajim.org/index.fr.html) (Linux), [thunderbird](https://www.mozilla.org/fr/thunderbird/) (multiplateforme), [Jitsi](http://jitsi.org/) (multiplateforme) ou [Adium](https://adium.im/) (Mac OS).
@@ -27,21 +25,20 @@ Vous pouvez également utiliser un client desktop comme [Pidgin](http://pidgin.i
Voici une liste plus exhaustive des clients XMPP : https://fr.wikipedia.org/wiki/Liste_de_clients_XMPP
-### Chiffrer ses conversations avec OTR
+### Chiffrer ses conversations avec OMEMO
-Il est possible de chiffrer ses conversations XMPP à l’aide de [OTR](https://otr.cypherpunks.ca/index.php#downloads), notamment en utilisant Pidgin :
-* Installer `pidgin` et le plugin [`pidgin-otr`](https://otr.cypherpunks.ca/index.php#downloads)(sous linux il devrait être disponible avec votre gestionnaire de paquet)
+Il est possible de chiffrer ses conversations XMPP à l’aide de [OMEMO](https://xmpp.org/extensions/xep-0384.html), notamment en utilisant Gajim :
+* Installer `gajim` et le plugin `gajim-omemo`
* Activez le plugins dans `Outils > Plugins`
-* Faite `produire` pour générer une empreinte
-* Activez le chiffrement dans une conversation avec un contact disposant de l’OTR.
+* L'activer
+* Activez le chiffrement dans une conversation avec un contact disposant de OMEMO.
### Salon de discussion
-Pour créer un salon de discussion (Multi-user chat) sur votre serveur Yunohost utilisez l’identifiant nomsalon@muc.domaine.tld (ou domaine.tld est le domaine principal de votre serveur).
+Pour créer un salon de discussion (Multi-user chat) sur votre serveur Yunohost utilisez l’identifiant nomsalon@muc.domaine.tld (où domaine.tld est le domaine principal de votre serveur).
Si vous utilisez un nom de domaine personnel, il est nécessaire d’[ajouter une redirection de `type CNAME` pour le sous domaine `muc.`](dns_config_fr) au niveau de votre serveur DNS.
### VoIP et visioconférence
Un moyen pratique d’appeler un contact XMPP, en VoIP ou en appel vidéo, est d’utiliser le client [Jitsi](http://jitsi.org/).
-
diff --git a/accounting.md b/accounting.md
deleted file mode 100644
index 988b342b..00000000
--- a/accounting.md
+++ /dev/null
@@ -1,3 +0,0 @@
-#Accounting
-
-If you want to contribute to this documentation, you have to [ask an admin to create an account](/support) **OR** send merge requests to the pages' [git repository](https://github.com/YunoHost/doc).
diff --git a/accounting_fr.md b/accounting_fr.md
deleted file mode 100644
index 45d433c6..00000000
--- a/accounting_fr.md
+++ /dev/null
@@ -1,3 +0,0 @@
-#Comptes utilisateur
-
-Si vous voulez contribuer à cette documentation, vous devez [demander à un administrateur de vous créer un compte](/support_fr), ou modifier directement le répertoire des pages via le [dépôt Git](https://github.com/YunoHost/doc).
\ No newline at end of file
diff --git a/admin.md b/admin.md
index 6793e8c8..d462c05c 100644
--- a/admin.md
+++ b/admin.md
@@ -1,8 +1,6 @@
# Administrator web interface
-Yunohost has an administrator web interface. The other way to administer your Yunohost install is through the [CLI called "moulinette"](/moulinette)
-
-**Please note** that the web interface is an active work-in-progress and has far fewer features than the CLI moulinette.
+Yunohost has an administrator web interface. The other way to administrate your Yunohost install is through the [command line](/commandline).
### Access
@@ -12,20 +10,9 @@ You can access your administrator web interface at this address: https://example
+
### Reset admin password
-#### On Yunohost 2.5
-
-The script to reset the admin password is not directly available, but can be downloaded and executed (as root) :
-
-```bash
-$ wget https://raw.githubusercontent.com/YunoHost/yunohost/testing/sbin/yunohost-reset-ldap-password
-$ chmod +x yunohost-reset-ldap-password
-$ ./yunohost-reset-ldap-password
-```
-
-#### From Yunohost 2.6
-
To reset the admin password (as root) :
```bash
@@ -34,6 +21,7 @@ $ yunohost-reset-ldap-password
A temporary password will be created, which you can use to define the new password.
+
### How to move application folder
To change an application folder, only a few commands are needed: move content, create a symlink and set access rights.
diff --git a/admin_api_fr b/admin_api_fr.md
similarity index 100%
rename from admin_api_fr
rename to admin_api_fr.md
diff --git a/admin_fr.md b/admin_fr.md
index 4214b2ce..7dbcb32a 100644
--- a/admin_fr.md
+++ b/admin_fr.md
@@ -1,30 +1,18 @@
# L’interface d’administration web
-YunoHost est fourni avec une interface graphique d’administration. L’autre méthode est d’utiliser la [moulinette](/moulinette_fr) ligne de commande.
-
-**Attention** : l’interface d’administration donne accès à beaucoup moins de fonctionnalités que la moulinette, car elle est en développement actif.
+YunoHost est fourni avec une interface graphique d’administration. L’autre méthode est d’utiliser la [ligne de commande](/commandline_fr).
### Accès
+
L’interface admin est accessible depuis votre instance YunoHost à l’adresse https://exemple.org/yunohost/admin (remplacez exemple.org par la bonne valeur)
LimeSurvey
-LimeSurvey est un outil de création et diffusion de sondage/formulaire en ligne..
+LimeSurvey est un outil de création et diffusion de sondage/formulaire en ligne.
### Comment créer un questionnaire
Pour créer un questionnaire, il faut accéder à l'interface d'administration.
diff --git a/app_netdata.md b/app_netdata.md
new file mode 100644
index 00000000..f3831882
--- /dev/null
+++ b/app_netdata.md
@@ -0,0 +1,262 @@
+## NetData
+
+[NetData](http://my-netdata.io/) is a system for **distributed real-time performance and health monitoring**.
+It provides **unparalleled insights, in real-time**, of everything happening on the
+system it runs (including applications such as web and database servers), using
+**modern interactive web dashboards**.
+
+_netdata is **fast** and **efficient**, designed to permanently run on all systems
+(**physical** & **virtual** servers, **containers**, **IoT** devices), without
+disrupting their core function._
+
+[](https://install-app.yunohost.org/?app=piwigo)
+
+**Customization brought by the package:**
+
+* grant MySQL statistics access via a `netdata` user
+* nginx root log statistics via putting `netdata` user in the `adm` group
+* Dovecot statistics via giving access to Dovecot stats stocket to `netdata` user (works only with Dovecot 2.2.16+)
+
+**Further recommendations:**
+We don't allow YunoHost packages to make sensible changes to system files. So here are further customizations you can make to allow more monitoring:
+
+* Nginx:
+ * requests/connections: follow [these recommandations](https://github.com/firehol/netdata/tree/master/python.d#nginx) to enable `/stab_status` (for example by putting the `location` section in `/etc/nginx/conf.d/yunohost_admin.conf`
+ * weblogs: you can monitor all your nginx weblogs for errors; follow [these recommendations](https://github.com/firehol/netdata/tree/master/python.d#nginx_log)
+* phpfpm: follow [these recommandations](https://github.com/firehol/netdata/tree/master/python.d#phpfpm)
+
+## Features
+
+
+
+
+
+
+
+
+[Piwigo](http://piwigo.org) is a photo gallery software for the web, built by an active community of users and developers.
+
+Extensions make Piwigo easily customizable. Icing on the cake, Piwigo is free and opensource.
+
+[](https://install-app.yunohost.org/?app=piwigo)
+
+
+
+## Features
+
+In addition to Piwigo [core features](http://piwigo.org/basics/features), the following are made available with
+this package:
+
+ * Integrate with YunoHost users and SSO:
+ * private mode: limit access to Yunohost users
+ * public mode:
+ * SSO for YunoHost users
+ * allow other users management, and guest mode
+ * Allow one YunoHost user to be the administrator (set at the installation)
+
+
+## Links
+
+ * Report a bug: https://github.com/YunoHost-Apps/piwigo_ynh/issues
+ * Piwigo website: http://piwigo.org/
+
+
diff --git a/app_piwigo_fr.md b/app_piwigo_fr.md
new file mode 100644
index 00000000..ada13e24
--- /dev/null
+++ b/app_piwigo_fr.md
@@ -0,0 +1,30 @@
+##
+
+
+
+
+[Piwigo](http://piwigo.org) est un logiciel de galerie photo pour le web, bâti par une communauté active d'utilisateurs et de développeurs.
+
+Les extensions rendent Piwigo facilement personnalisable. Cerise sur le gâteau, Piwigo est libre et gratuit.
+
+[](https://install-app.yunohost.org/?app=piwigo)
+
+
+
+## Fonctionnalités
+
+En plus des [fonctionnalités principales](Piwigo) de Piwigo, ce paquet propose également:
+
+ * une intégration avec le système de gestion des utilisateurs et le SSO de Yunohost :
+ * installation privée : limitée aux utilisateurs de YunoHost
+ * installation publique :
+ * SSO pour les utilisateurs YunoHost
+ * permet de gérer l'accès à d'autres utilisateurs, et mode invité possible
+ * de permettre à un utilisateur d'être administrateur (réglage lors de l'installation)
+
+## Liens
+
+ * Rapport de bug: https://github.com/YunoHost-Apps/piwigo_ynh/issues
+ * Site web Piwigo : http://piwigo.org/
+
+
diff --git a/app_rainloop.md b/app_rainloop.md
new file mode 100644
index 00000000..1e33f67d
--- /dev/null
+++ b/app_rainloop.md
@@ -0,0 +1,19 @@
+# Rainloop
+
+Rainloop is a lightweight webmail.
+
+To configure it, go to http://DOMAIN.TLD/rainloop/app/?admin
+
+- The default login is : admin
+- The default password is : Password chosen during install
+- If you lost the admin password, you can retrieve it using ``sudo yunohost app settings rainloop password``
+
+Each user can add a remote carddav server from their own parameters interface.
+
+- If you use baikal, the CardDav address is: https://DOMAIN.TLD/baikal/card.php/addressbooks/USER/default/
+- If you use NextCloud, the CardDav address is: https://DOMAIN.TLD/nextcloud/remote.php/carddav/addressbooks/USER/contacts
+
+Rainloop saves your PGP private keys in the browser storage. This means that you will loose your private keys if you clear your browser storage (e.g., private browsing, different computer...). This packages integrates [PGPback by chtixof](https://github.com/chtixof/pgpback_ynh) so you can store your PGP private keys on the server securely. Go to **http://DOMAIN.TLD/rainloop/pgpback** to backup your PGP keys on the server or restore them.
+
+To upgrade the app once a new rainloop version is available, simply run in a local shell via ssh or otherwise :
+``sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/rainloop_ynh rainloop``
diff --git a/app_rainloop_fr.md b/app_rainloop_fr.md
new file mode 100644
index 00000000..012421e5
--- /dev/null
+++ b/app_rainloop_fr.md
@@ -0,0 +1,19 @@
+# Rainloop
+
+Rainloop est un webmail simple et léger.
+
+Pour le configurer après l'installation, veuillez vous rendre sur http://DOMAIN.TLD/rainloop/app/?admin
+
+- Le nom d'utilisateur admin par défaut est : admin
+- Le mot de passe admin par défaut est : Mot de passe choisi lors de l'installation
+- Si vous avez oublié votre mot de passe, vous pouvez le retrouver avec ``sudo yunohost app settings rainloop password``
+
+Chaque utilisateur peut ajouter un carnet d'adresse distant CardDav via leur propre paramètres.
+
+- Si vous utilisez Baikal, l'adresse à renseigner est du type : https://DOMAIN.TLD/baikal/card.php/addressbooks/UTILISATEUR/default/
+- Si vous utilisez NextCloud, l'adresse à renseigner est du type : https://DOMAIN.TLD/nextcloud/remote.php/carddav/addressbooks/USER/contacts
+
+Rainloop stocke les clés PGP privées dans le stockage de navigateur. Cela implique que vos clés seront perdues quand vous videz le stockage de navigateur (navigation incognito, changement d'ordinateur, ...). Ce paquet intègre [PGPback de chtixof](https://github.com/chtixof/pgpback_ynh) pour que vous puissiez stocker vos clés privées PGP de manière sécurisée sur le serveur. Rendez-vous **http://DOMAIN.TLD/rainloop/pgpback** pour stocker vos clés privées PGP sur le serveur ou les restaurer dans un nouveau navigateur.
+
+Pour mettre à jour rainloop lorsqu'une nouvelle version est disponible, lancez en console locale (ssh ou autre) :
+``sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/rainloop_ynh rainloop
diff --git a/app_ttrss.md b/app_ttrss.md
index f93d08a4..8ccedfa0 100644
--- a/app_ttrss.md
+++ b/app_ttrss.md
@@ -1,4 +1,4 @@
-#
Tiny Tiny RSS
+# Tiny Tiny RSS
Tiny Tiny RSS is a news feed reader using RSS and atom protocols.
@@ -10,11 +10,11 @@ In order to do so, go to Actions -> Configuration -> feed tab -> OPML section ->
You can read your feeds on Android using ttrss-reader application:
-**[ttrss-reader](https://f-droid.org/repository/browse/?fdfilter=rss&fdid=org.ttrssreader)**
+**[ttrss-reader](https://f-droid.org/packages/org.ttrssreader/)**
To use it, you need to go to Actions -> Configuration, in TTRSS web interface and select "Activate API".
Then, in your android ttrss-reader, fill the TTRSS server adress: "https://yourdomain.org/ttrss", username, password (no need to use HTTP authentification).
**Note** : you may need to uninstall and reinstall the TTRSS application through the Yunohost admin panel in order to be able to connect.
-* [Tiny Tiny RSS Website](http://tt-rss.org/redmine/projects/tt-rss/wiki)
+* [Tiny Tiny RSS Website](https://git.tt-rss.org/git/tt-rss/wiki)
diff --git a/app_ttrss_fr.md b/app_ttrss_fr.md
index 79c06fa6..be8b239c 100644
--- a/app_ttrss_fr.md
+++ b/app_ttrss_fr.md
@@ -1,4 +1,4 @@
-#Tiny Tiny RSS
+# Tiny Tiny RSS
Tiny Tiny RSS est un lecteur de flux d’actualité utilisant les protocoles RSS et atom.
@@ -11,11 +11,11 @@ Pour cela, il faut aller dans Actions -> Configuration -> onglet flux -> chapitr
Il est possible d’utiliser le client Android ttrss-reader pour consulter ces flux :
-**[ttrss-reader](https://f-droid.org/repository/browse/?fdfilter=rss&fdid=org.ttrssreader)**
+**[ttrss-reader](https://f-droid.org/packages/org.ttrssreader/)**
Sur l’interface web, dans Actions -> Configuration, cochez « Activer l’accès par API »
puis dans ttrss-reader sur Android, l’adresse du serveur TTRSS : « https://votredomaine.org/ttrss », nom d’utilisateur, mot de passe. (pas besoin d’utiliser l’authentification HTTP)
**Note** : vous pouvez avoir besoin de désinstaller, puis réinstaller entièrement l’app ttrss via l’administration de YunoHost pour que la connexion puisse se faire.
-* [Site de Tiny Tiny RSS](http://tt-rss.org/redmine/projects/tt-rss/wiki)
\ No newline at end of file
+* [Site de Tiny Tiny RSS](https://git.tt-rss.org/git/tt-rss/wiki)
diff --git a/app_update_fr.md b/app_update_fr.md
index 59add4a0..09d1ab89 100644
--- a/app_update_fr.md
+++ b/app_update_fr.md
@@ -1,29 +1,30 @@
#Mettre à jour ses applications
-Une fois que vous avez installé des applications, il est nécessaire de les mettre à jour.
+Une fois que vous avez installé des applications, il est nécessaire de les mettre à jour. Plusieurs méthodes existent et sont détaillées ci-dessous.
-** Attention : ** il est recommandé de faire une sauvegarde de la base de données (par exemple via l’application phpmyadmin) ainsi que des fichiers avant une opération de mise à jour.
+** Attention : ** il est recommandé de faire une sauvegarde de la base de données (par exemple via l’application [phpmyadmin](https://github.com/YunoHost-apps/phpmyadmin_ynh) ([installer](https://install-app.yunohost.org/?app=phpmyadmin))) ainsi que des fichiers avant une opération de mise à jour.
### Mise à jour par l’interface web
-Pour cela, il faut aller dans Outils > Mettre à jour le système.
+Pour cela, il faut aller dans l’onglet "Mettre à jour le système".
+
+Une fois la liste des paquets et des applications rafraîchie, il sera proposé de mettre à jour les applications et paquets qui peuvent l’être.
-Une fois la liste des paquets d’applications récupérée la page proposera de mettre à jour les applications officielles qui ont une mise à jour en attente.
### Mise à jour en ligne de commande
-Il faut d’abord se connecter sur le serveur en ssh, puis taper cette commande (dans le cas d’une mise à jour WordPress).
+Il faut d’abord se connecter sur le serveur en ssh, puis entrer la commande suivante (dans le cas d’une mise à jour WordPress) :
```bash
yunohost app upgrade wordpress
```
-** Note : ** dans le cas où plusieurs applications du même type (ex : deux WordPress) sont installés, il est nécessaire de spécifier le nom d’instance (ex : wordpress ou wordpress__2).
+** Note : ** dans le cas où plusieurs applications du même type (ex : deux WordPress) sont installées sur le serveur, il est nécessaire de spécifier le nom d’instance (ex : wordpress ou wordpress__2).
#### Mise à jour d’une application non officielle
Il faut pour cela indiquer le dépôt git qui contient la mise à jour.
-Par exemple pour mettre à jour LimeSurvey :
+Par exemple, pour mettre à jour LimeSurvey, entrer :
```bash
yunohost app upgrade limesurvey -u https://github.com/zamentur/limesurvey_ynh
```
-** Note : ** faites attention aux applications/mises à jour non officielles que vous installez. Assurez-vous que ces mises à jour sont stables et ne constituent pas une étape de développement. Si une application ou une mise à jour n’est pas intégrée au dépôt officiel, il y a peut-être une raison.
+** Note : ** faites attention aux applications/mises à jour non officielles que vous installez. Assurez-vous que ces mises à jour sont stables et ne constituent pas une étape de développement. Si une application ou une mise à jour n’est pas intégrée au dépôt officiel, il y a sûrement une raison.
-** Attention : ** assurez-vous du contenu de cette mise à jour ; l’installation ou la mise à jour d’une application non officielle permet à cette application d’exécuter des scripts avec les privilèges les plus élevés.
+** Attention : ** assurez-vous du contenu de cette mise à jour ; l’installation ou la mise à jour d’une application non officielle permet à cette dernière d’exécuter des scripts avec les privilèges les plus élevés. Si le script est malicieux, il pourrait nuire à votre vie privée en communiquant à des tiers toute donnée présente sur le serveur, ou bien les détruire irrémédiablement.
diff --git a/app_wallabag2.md b/app_wallabag2.md
new file mode 100644
index 00000000..823bcd06
--- /dev/null
+++ b/app_wallabag2.md
@@ -0,0 +1,33 @@
+## 
+
+[Wallabag](https://www.wallabag.org/) is a self hostable Read-It-Later application allowing
+you to not miss any content anymore. Click, save, read it when you can.
+It extracts content so that you can read it when you have time.
+
+[](https://install-app.yunohost.org/?app=wallabag2)
+
+It provides a web interface, browser (Firefox / Chrome / Opera) add-ons, mobile apps (Android / iOS / Windows Phone) and even on e-reader (PocketBook / Kobo)
+
+### Features
+
+In addition to Wallabag core features, the following are made available with
+this package:
+
+ * Integrate with YunoHost users and SSO - i.e. logout button
+ * Allow one user to be the administrator (set at the installation)
+ * Asynchronous import using Redis (need to be enabled in the *Internal Settings*). RabbitMQ import not supported (yet ?)
+
+### Links
+
+ * Report a bug: https://github.com/YunoHost-Apps/wallabag2_ynh/issues
+ * Wallabag website: https://www.wallabag.org/
+ * Wallabag documentation: https://doc.wallabag.org/ (fr/en/it/de)
+ * [Video demo](https://vimeo.com/video/167435064)
+
+----
+
+### Upgrade from v1.x
+
+No automatic upgrade process is available. You need a manual (but simple) migration from [Wallabag v1](https://github.com/YunoHost-Apps/wallabag_ynh).
+Please take a look at the [official documentation](https://doc.wallabag.org/en/user/import/wallabagv1.html).
diff --git a/app_wallabag2_fr.md b/app_wallabag2_fr.md
new file mode 100644
index 00000000..ba387f5c
--- /dev/null
+++ b/app_wallabag2_fr.md
@@ -0,0 +1,30 @@
+##
+
+
+[Wallabag](https://www.wallabag.org/) est une application de lecture différée : elle permet simplement d’archiver une page web en ne conservant que le contenu. Les éléments superflus (menus, publicités, etc.) sont supprimés.
+
+Sont disponibles: une interface web, des add-ons pour navigateurs (Firefox / Chrome / Opera), des applications pour mobile (Android / iOS / Windows Phone) et même sur liseuse (PocketBook / Kobo).
+
+[](https://install-app.yunohost.org/?app=wallabag2)
+
+### Fonctionnalités
+
+En plus des fonctionnalités principales de Wallabag, ce paquet propose également:
+
+ * Une intégration avec le système de gestion des utilisateurs et le SSO de Yunohost - e.g. un bouton de déconnexion
+ * De permettre à un utilisateur d'être administrateur (réglage lors de l'installation)
+ * Un import asynchrone utilisant Redis (à activer dans les *Paramètres Internes*). L'import via RabbitMQ n'est pas (encore ?) supporté.
+
+### Liens
+
+ * Rapport de bug: https://github.com/YunoHost-Apps/wallabag2_ynh/issues
+ * Site web de Wallabag: https://www.wallabag.org/
+ * Documentation de Wallabag: https://doc.wallabag.org/ (fr/en/it/de)
+ * [Demo vidéo](https://player.vimeo.com/video/167435064)
+
+ ----
+
+ ### Mettre à niveau depuis la v1.x
+
+La mise à niveau depuis le paquet Yunohost de [Wallabag v1](https://github.com/YunoHost-Apps/wallabag_ynh) demande une opération manuelle, c'est pourquoi un nouveau paquet est fournit.
+Pour le processus de migration, merci de vous référer à [la documentation officiel de Wallabag](https://doc.wallabag.org/fr/user/import/wallabagv1.html).
diff --git a/apps.md b/apps.md
index 01345a25..c1bcb3ef 100644
--- a/apps.md
+++ b/apps.md
@@ -1,44 +1,142 @@
-#Official apps
+# Apps
-
-
-
-
-
-
-
-
-
-
-
-Official apps Apps in progress Apps wishlist
-
-Only apps tagged validated are officially supported by the package team.
+ +Apps tagged working, inprogress, notworking are from community repository, you can test and use them **at your own risk**.
+ +Important: it's the application maintaineur that qualify his application as working, not the YunoHost core team. Install it at your own risks. We won't provide support for it.
+إلّا التطبيقات المحددة بعلامة validated تعتبر مدعومة رسميا من طرف فريق التحزيم.
+ +Les apps marquées working, inprogress, notworking sont des applications non officielles maintenues par la communauté, vous pouvez les tester et les utiliser **à vos risques et périls**.
+ +Important: c'est le mainteneur de l'application qui définit son application comme "working" et non pas l'équipe d'empaquetage de Yunohost. Installez ces apps à vos risques et périls. Nous ne fournissons pas de support pour elles.
+
-
-
-
-
-
-
-
-
-
-
-Apps officielles Apps en cours Apps souhaitées
-
-Seules les apps marquées validated sont officiellement supportées par l'équipe de développement d'applications.
+ +Les apps marquées working, inprogress, notworking sont des applications non officielles maintenues par la communauté, vous pouvez les tester et les utiliser **à vos risques et périls**.
+ +Important: c'est le mainteneur de l'application qui définit son application comme "working" et non pas l'équipe de développement d'applications de Yunohost. Installez ces apps à vos risques et périls. Nous ne fournissons pas de support pour elles.
+
-
-
-
-
-
-
-
-
-
-
-Official apps
-Apps in progress
-Apps wishlist
-
-The following applications are being packaged on by a growing number of packagers.
-Important: it's the application maintaineur that qualify his application as working, not the YunoHost core team. Install it at your own risks. We won't provide support for it.
- - - -Those are not yet finished applications, we strongly advise against installing them except if you know what you are doing.
- - - -Do NOT install them, they are here as reference while they aren't fixed.
- - - - - - diff --git a/apps_in_progress_fr.md b/apps_in_progress_fr.md deleted file mode 100644 index 6b76fb4f..00000000 --- a/apps_in_progress_fr.md +++ /dev/null @@ -1,137 +0,0 @@ -# Apps en cours - -
-
-
-
-
-
-
-
-
-
-
-Apps officielles
-Apps en cours
-Apps souhaitées
-
-De plus en plus d’applications sont mises à disposition par les packagers.
-Remarque : c'est le mainteneur de l'application qui la décrit comme fonctionnelle, pas l'équipe de YunoHost. Installez la à vos risques et péril et soyez conscient que ne fournirons aucune assistance dessus.
- - - -Il s'agit d'application pas encore fonctionnelles mais en cours de développement, nous vous déconseillons fortement de les installer sauf si vous savez ce que vous faites.
- - - -Ne les installez PAS, elles sont là pour référence le temps d'être réparées.
- - - - - - diff --git a/apps_wishlist.md b/apps_wishlist.md index 52b55a5a..72eff631 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -1,6 +1,6 @@ # Apps wishlist -Official apps Apps in progress Apps wishlist +
-
-
-
-Click to download.
-
-Licence: CC-BY-SA 4.0
\ No newline at end of file
diff --git a/artworks_fr.md b/artworks_fr.md
deleted file mode 100644
index ccf242b9..00000000
--- a/artworks_fr.md
+++ /dev/null
@@ -1,10 +0,0 @@
-#Travail artistique
-Logo Yunohost noir et blanc réalisé par ToZz (400 × 400 px) :
-
-
-
-
-
-Cliquer pour télécharger.
-
-Licence: CC-BY-SA 4.0
\ No newline at end of file
diff --git a/backup.md b/backup.md
index 358e70b7..fea99dbe 100644
--- a/backup.md
+++ b/backup.md
@@ -1,165 +1,149 @@
-# Backup
+Backing up your server and apps
+===============================
-First make sure that the `archives` folder exists in `/home/yunohost.backup/`. If it does not, create it with:
+Backing up your server, apps and data is an important concern when administrating a server. This protects you from unexpected events that could happen (server lost in a fire, database corruption, loss of access, server compromised, ...). The backup policy you will put in place depends of the importance of the services and data hosted. For instance you won't care too much about having backup on a test server, but you will care about having a backup of critical data of your association or company, and having this backup *in a different physical place*.
+
+Backups in the context of YunoHost
+----------------------------------
+
+YunoHost comes with a backup system, that allows to backup (and restore) system configurations and data (e.g. mails) and apps if they support it.
+
+You can manage backups either from the command line (`yunohost backup --help`) or from the web administration (in the Backups section) though some features are not yet available in the webadmin.
+
+The current default method consists in creating a `.tar.gz` archive containing all relevant files. In the future, YunoHost plans to support [Borg](https://www.borgbackup.org/) which is a more flexible, efficient and powerful solution.
+
+Creating backups
+----------------
+
+#### From the webadmin
+
+You can easily create backup archives from the webadmin by going in Backups > Local storage and clicking on "New backup". You will then be asked to select which configuration, data and apps you want to backup.
+
+
+
+#### From the command line
+
+You can create a new backup archive with the command line. Here are a few simple example of commands and their corresponding behavior :
+
+- Backing up everything (all system parts and apps) :
```bash
-sudo mkdir /home/yunohost.backup/archives
+yunohost backup create
```
-Launch a backup via
+- Backing up only apps
```bash
-sudo yunohost backup create
+yunohost backup create --apps
```
-
-In this version you can backup with cli or with the web admin. The cli way allows you to do more things. The webadmin way is more accessible.
-
-## Web admin
-Basically with the webadmin, you can:
-
-- backup into `/home/yunohost/archives/`
-- choose to backup one or more data among:
- - apps data
- - emails
- - home data
- - configuration
-- list backups
-- see what there is in a backup
-- restore selectively a backup
-
-**Caution:** to do a backup, you need to have enough free disk spaces in the destination directory. For example, if you have 20GB in `/home/data` you need to have enough space to contain this 20GB compressed in a tar.gz. To do the tar.gz, yunohost backup uses shallow copies, to avoid to need more spaces to be able to create the tar.gz.
-
-**Caution:** If you use selective restore, be sure to not create discordant operation. For example, if you restore an app using a domain that has been deleted from YunoHost, you need to read the domain or to restore all configuration files.
-
-Here's a list of missing but planned features:
-
-- backup in another memory device
-- download/upload backups
-- encrypt backups
-
-Some features are almost ready in the webadmin, but the API is not for the moment.
-
-## Command line
-### Backup
-You can make a full backup by running this command:
+- Backing up only two apps (wordpress and shaarli)
```bash
-admin@yunohost:~# sudo yunohost backup create
-Exécution des scripts de sauvegarde...
-Attention : backup script '/etc/yunohost/apps/phpmyadmin/scripts/backup' not found
-Attention : App 'phpmyadmin' will not be saved
-Lancement du script de sauvegarde de l'application 'odoo'...
-Création de l'archive de sauvegarde...
-Succès ! Sauvegarde terminée
-archive:
- hooks:
- conf_ssh: /usr/share/yunohost/hooks/backup/08-conf_ssh
- conf_ynh_firewall: /usr/share/yunohost/hooks/backup/20-conf_ynh_firewall
- data_mail: /usr/share/yunohost/hooks/backup/23-data_mail
- conf_cron: /usr/share/yunohost/hooks/backup/32-conf_cron
- conf_ynh_certs: /usr/share/yunohost/hooks/backup/21-conf_ynh_certs
- conf_ynh_mysql: /usr/share/yunohost/hooks/backup/11-conf_ynh_mysql
- conf_xmpp: /usr/share/yunohost/hooks/backup/26-conf_xmpp
- data_home: /usr/share/yunohost/hooks/backup/17-data_home
- conf_nginx: /usr/share/yunohost/hooks/backup/29-conf_nginx
- conf_ssowat: /usr/share/yunohost/hooks/backup/14-conf_ssowat
- conf_ldap: /usr/share/yunohost/hooks/backup/05-conf_ldap
- created_at: 1448540733
- apps:
- odoo:
- version: -
- name: Odoo
- description: Odoo est une collection d'apps de gestion d'entreprise (ERP : CRM, Comptabilité, Point de Vente, RH, Achats, ...).
- description:
- name: 20151126-132533
-admin@yunohost:~# sudo ls /home/yunohost.backup/archives/
-20151126-132533.info.json 20151126-132533.tar.gz
+yunohost backup create --apps wordpress shaarli
```
-By default, it backups in `/home/yunohost.backup/archives/`, but you can set your own directory with `-o` option. It could be an usb key or an other mounted filesystem.
-If an app has no backup script it warns you.
-
-As you can see in the answer, there is 2 hooks which backup data (data_home and data_mail). By default, the mysql data aren't saved, because the apps should save themselves their databases.
-
-
-**Note:** `yunohost backup` is not able currently to create diff backup. But you can use `-r` option to avoid compression and use an other backup tool to make diff backup.
-
-### Restore
-To do a restore
+- Backing up only mails
```bash
-admin@yunohost:~# sudo yunohost backup restore 20151126-132533
+yunohost backup create --system data_mail
```
-You can choose to apply only some parts of the backup, by selecting which restore hooks and which apps to restore.
-## Packaging information
-You can see an example to make backup and restore scripts here
-https://github.com/YunoHost/example_ynh/tree/testing
-and
-https://github.com/zamentur/strut_ynh/
-
-There is some helpers to do shadow copy if you have big quantity of data to backup (owncloud, video apps, etc...).
-
-**Note:** during a backup operation, the restore script associated is saved. So in a restore operation, yunohost use the saved restore script and not the most recent script.
-
-If you want modify a general conf file, you should use hooks to trigger a modification of the conf file after each call of `yunohost regenconf`.
-You can also use the regeneration configuration system to do index your conf file, and allow your user to be warn if an upgrade of your app has change a config file.
-
-## Annex
+- Backing up mails and wordpress
```bash
-usage: yunohost backup create [-h] [-d DESCRIPTION] [-o OUTPUT_DIRECTORY]
- [-n NAME] [--ignore-hooks]
- [--hooks [HOOKS [HOOKS ...]]]
- [--apps [APPS [APPS ...]]] [-r] [--ignore-apps]
-
-optional arguments:
- -h, --help show this help message and exit
- -d DESCRIPTION, --description DESCRIPTION
- Short description of the backup
- -o OUTPUT_DIRECTORY, --output-directory OUTPUT_DIRECTORY
- Output directory for the backup
- -n NAME, --name NAME Name of the backup archive
- --ignore-hooks Do not execute backup hooks
- --hooks [HOOKS [HOOKS ...]]
- List of backup hooks names to execute
- --apps [APPS [APPS ...]]
- List of application names to backup
- -r, --no-compress Do not create an archive file
- --ignore-apps Do not backup apps
-
-usage: yunohost backup restore [-h] [--force] [--hooks [HOOKS [HOOKS ...]]]
- [--ignore-hooks] [--apps [APPS [APPS ...]]]
- [--ignore-apps]
- name
-
-positional arguments:
- name Name of the local backup archive
-
-optional arguments:
- -h, --help show this help message and exit
- --force Force restauration on an already installed system
- --hooks [HOOKS [HOOKS ...]]
- List of restauration hooks names to execute
- --ignore-hooks Do not restore hooks
- --apps [APPS [APPS ...]]
- List of application names to restore
- --ignore-apps Do not restore apps
-
-
-usage: yunohost backup [-h] {info,restore,create,list,delete} ...
-
-optional arguments:
- -h, --help show this help message and exit
-
-actions:
- {info,restore,create,list,delete}
- info Show info about a local backup archive
- restore Restore from a local backup archive
- create Create a backup local archive
- list List available local backup archives
- delete Delete a backup archive
-root@staging1:/home/admin# sudo yunohost backup list --help
-usage: yunohost backup list [-h] [-i] [-H]
-
-optional arguments:
- -h, --help show this help message and exit
- -i, --with-info Show backup information for each archive
- -H, --human-readable Print sizes in human readable format
+yunohost backup create --system data_mail --apps wordpress
```
+
+For more informations and options about backup creation, consult `yunohost backup create --help`. You can also list system parts that can be backuped with `yunohost hook list backup`.
+
+#### Apps-specific configuration
+
+Some apps such as nextcloud may be related to a large quantity of data which are not backuped by default. This practice is referred to "backing up only the core" (of the app). However it's possible to enable the backup of all data of this app with `yunohost app setting nextcloud backup_core_only -v 0`. Be careful though that your archive might get huge if there's too much data to be backuped...
+
+Downloading and uploading backups
+---------------------------------
+
+After creating backup archives, it is possible to list and inspect them via the corresponding views in the webadmin, or via `yunohost backup list` and `yunohost backup info 
+* User: **root**
+* Password: **yunohost**
-You can proceed to post-installation right away, or access the **IP** address shown on this screen from another computer's web browser (usually `http://192.168.x.x`)
+## 5. Proceed to post-installation
-
+Post-install documentation
-If you encounter this kind of error, click on "**Proceed**" or "**Add an exception**".
-This means that you have to trust the certificate which secures your server's connections.
-Since this is your server, you can bypass it serenely here :-)
-
-
----
-
-#### More information on the post-installation here:
-
-**[yunohost.org/postinstall](/postinstall)**
diff --git a/boot_and_graphical_install_fr.md b/boot_and_graphical_install_fr.md
index 1960b2f8..fcfd7c72 100644
--- a/boot_and_graphical_install_fr.md
+++ b/boot_and_graphical_install_fr.md
@@ -15,7 +15,7 @@ Démarrez votre serveur avec la clé USB ou le CD-ROM inséré, et sélectionnez
## 3. Lancer l’installation graphique
-Vous devriez voit un écran comme ça :
+Vous devriez voir un écran comme ça :
@@ -35,26 +35,16 @@ Vérifiez que votre serveur est bien branché et réessayez.
+* User: **root**
+* Password: **yunohost**
-Vous pouvez procéder à la post-installation directement, ou accéder à l’adresse **IP** affichée sur cet écran depuis un navigateur web d’un autre ordinateur (généralement `http://192.168.x.x`)
+## 5. Procéder à la post-installation
-
+Documentation de la post-installation
-Si vous rencontrez une erreur de ce type, cliquez sur « **Poursuivre quand même** » ou « **Ajouter une exception** ».
-Cela signifie que vous devez faire confiance au certificat qui sécurise les connexions avec votre serveur.
-Comme c’est le votre, vous pouvez le valider sereinement ici :-)
-
-
-
----
-
-#### Plus d’informations sur la post-installation ici :
-
-**[yunohost.org/postinstall](/postinstall)**
diff --git a/build_arm_image.md b/build_arm_image.md
deleted file mode 100644
index 20775dc5..00000000
--- a/build_arm_image.md
+++ /dev/null
@@ -1,124 +0,0 @@
-# Build ARM image
-
-This tutorial's goal is to build a plug-and-play image for YunoHost for ARM boards.
-
-It could be used on many ARM board (Rasberry Pi, Olimex, Cubieboard…).
-
-This tutorial is based on [Yunocubian](https://github.com/M5oul/Yunocubian).
-
-You could find [ARM image builder from Debian Jessie](https://github.com/YunoHost/install_script/pull/36).
-
-**All these steps can be executed with variations of [this script](https://github.com/likeitneverwentaway/rpi_buildbot/blob/master/build_image.sh).**
-
-### Download minimal Debian Jessie
-Download a Debian Jessie image compatible with the hardware **without desktop environnement** installed:
-
-* [ARMbian](http://www.armbian.com/download/) (Olimex, Cubieboard, Banana Pi…)
-* [Raspbian Jessie Lite](https://www.raspberrypi.org/downloads/raspbian/)
-
-### Copy image and install YunoHost
-Copy image to the SD card
-
-Plug & boot
-
-* Connect via [SSH](ssh): **pi@exemple.tld/ip_address** with the password **raspberry** (or any variations for other distros than Raspbian).
-* Set a root password :
-
-```bash
-sudo passwd
-```
-
-and login as root:
-```bash
-su
-```
-
-
-* You should be **root** for next operations.
-
-Manually install YunoHost on a Raspberry Pi
-
-If you encounter problems during installation check out [this installation guide](http://avignu.wiki.tuxfamily.org/doku.php?id=documentation:yunohost-jessie) for the Raspberry Pi, based on suggestion [from this thread](https://forum.yunohost.org/t/installation-de-yunohost-2-4-sur-raspbian-jessie-minimal-sur-un-raspberry-pi-3/1597).
-
-
-
+
+
---
## USB key
-Download UnetBootin for your operating system and install it.
+### With Etcher
+Download Etcher for your operating system and install it.
+
+
+
+Put your USB key on, select your YunoHost ISO and click "Flash"
+
+### With UNetbootin
+
+Download UNetbootin for your operating system and install it.
Put your USB key on, select your YunoHost ISO and click "OK"
+### With `dd`
+
+If you know your way around command line, you may also flash your USB key with
+`dd`. Assuming your USB key is `/dev/sdb` (be careful !!), you may run :
+
+```bash
+dd if=/path/to/yunohost.iso of=/dev/sdb
+```
---
@@ -27,4 +44,4 @@ The software to use differs regarding your operating system.
* On Mac OS, use [Disk Utility](http://support.apple.com/kb/ph7025)
-* On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/)
\ No newline at end of file
+* On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/)
diff --git a/burn_or_copy_iso_fr.md b/burn_or_copy_iso_fr.md
index ab551e85..577c79aa 100644
--- a/burn_or_copy_iso_fr.md
+++ b/burn_or_copy_iso_fr.md
@@ -1,20 +1,39 @@
-# Copier l’image ISO
+# Flasher l'ISO YunoHost sur une clef USB ou un CD/DVD
-Maintenant que vous avez l’image ISO de YunoHost, vous devez la mettre sur un support physique : **Clé USB** ou **CD/DVD**
+Maintenant que vous avez téléchargé l’image ISO de YunoHost, vous devez la mettre sur un support physique : une **Clé USB** ou un **CD/DVD**.
-
-
+
+
---
## Clé USB
-Téléchargez la version d’UnetBootin pour votre système d’exploitation et installez-la.
+### Avec Etcher
+
+Téléchargez Etcher pour votre système d'exploitation et installez-le.
+
+
+
+Branchez votre clef USB, selectionnez l'ISO YunoHost puis cliquez sur 'Flash'
+
+### Avec UNetbootin
+
+Téléchargez UNetbootin pour votre système d'exploitation et installez-le.
-Insérez votre clé USB, sélectionnez l’image ISO YunoHost et cliquez sur **OK**.
+Branchez votre clef USB, selectionnez l'ISO YunoHost puis cliquez sur 'OK'
+### Avec `dd`
+
+Si vous êtes familier avec la ligne de commande, il est possible de flasher la
+clef USB avec `dd`. En supposant que votre clef USB soit `/dev/sdb` (faites
+attention !!), vous pouvez exécuter :
+
+```bash
+dd if=/chemin/de/yunohost.iso of=/dev/sdb
+```
---
diff --git a/certificate.md b/certificate.md
index 244344d8..525c8957 100644
--- a/certificate.md
+++ b/certificate.md
@@ -1,121 +1,92 @@
-#Certificate
+# Certificate
-Certificates are used to certify that your server is the genuine one and not a falsified one.
+Certificates are used to certify that your server is the genuine one, and not an attacker trying to impersonate it.
-YunoHost provides a **self-signed** certificate, it means that your server guaranty the certificate validity. It's enough **for personal usage**, because you trust your own server. But this could be a problem if you want to open access to anonymous like web user for a website.
-Concretely users will go throw a screen like this:
+YunoHost provides a **self-signed** certificate, it means that your server guaranties the certificate validity. It's enough **for personal usage**, because you trust your own server. But this could be a problem if you want to open access to anonymous like web user for a website.
+
+In practice, visitors will see a screen list this:
-This screen ask to the user : **"Do you trust this server that host this website?"**
-It could afraid a lot of users (rightly).
+Which basically asks the visitor : **"Do you trust the server hosting this website?"**. This can rightfully frighten a lot of people.
-To avoid this confusion, it's possible to get a signed certificate by a "known" authority : **Gandi**, **RapidSSL**, **StartSSL**, **CaCert**.
-In these cases, the point is to replace the self-signed certificate with the one that has been certified by a certificate authority, and the users won't have this warning screen anymore.
+To avoid this confusion, it's possible to get a certificate signed a known
+authority named **Let's Encrypt** which provide free certificates directly
+recognized by browsers. YunoHost allows to directly install this certificate
+from the web administration interface or from the command line.
-### Add a signed certificate by an authority
+### Install a Let's Encrypt certificate
-Get your certificate from your CA, you must get a private key, file key and a public certificate (file .crt)
-> Be carefull, the key file is very critical, it's strictly personal and have to be secured.
+Before attempting to install a Let's Encrypt certificate, you should make sure
+that your DNS is correctly configured (votre.domaine.tld should point to
+your server's IP) and that your domain is accessible though HTTP from outside
+your local network (i.e. at least port 80 should be forwarded to your server).
-Copy this two files on the server, if not.
+#### From the web administration interface
+
+Go to the 'Domain' part of the admin interface, then in the section dedicated to
+your.domain.tld. You should find a 'SSL certificate' button :
+
+
+
+In the 'SSL certificate' section, you can see the status of the current
+certificate. If you just added the domain, it should be a self-signed
+certificate.
+
+
+
+If your domain is correctly configured, it is then possible to install the
+Let's Encrypt certificate via the green button.
+
+
+
+Once the install is made, you can check that the certificate is live via your
+browser by going to your domain in HTTPS. The certificate will automatically
+be renewed every three months.
+
+
+
+#### From the command line interface
+
+Connect to your server through SSH.
+
+You can check the status of your current certificate with :
```bash
-scp CERTIFICAT.crt admin@DOMAIN.TLD:ssl.crt
-scp CLE.key admin@DOMAIN.TLD:ssl.key
+yunohost domain cert-status your.domain.tld
```
-From Windows, scp can be used with putty, download [pscp](http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe)
+Install a Let's Encrypt certificate with
```bash
-pscp -P 22 CERTIFICAT.crt admin@DOMAIN.TLD:ssl.crt
-pscp -P 22 CLE.key admin@DOMAIN.TLD:ssl.key```
+yunohost domain cert-install your.domain.tld
+```
-Now the files are in the server. Open a shell on the server use [ssh](https://yunohost.org/#/ssh_fr) or locally.
-
-First, create a directory for archive the certificates.
+This should return :
```bash
-sudo mkdir /etc/yunohost/certs/DOMAIN.TLD/ae_certs
-sudo mv ssl.key ssl.crt /etc/yunohost/certs/DOMAIN.TLD/ae_certs/```
+Success! The SSOwat configuration has been generated
+Success! Successfully installed Let's Encrypt certificate for domain DOMAIN.TLD!
+```
-Then go to the parent directory and go on.
+Once this is done, you can check that the certificate is live via your
+browser by going to your domain in HTTPS. The certificate will automatically
+be renewed every three months.
+
+##### Troubleshooting
+
+If due to some bad tweaking, your certificate ends up in a bad state (e.g.
+lost the certificate or unable to read the files), you should be able to clean
+the situation by regenerating a self-signed certificate :
```bash
-cd /etc/yunohost/certs/DOMAIN.TLD/```
+yunohost domain cert-install your.domain.tld --self-signed --force
+```
-Make a backup of the YunoHost original certificates , to be safe!
+If YunoHost thinks that your domain is badly configured despite the fact that
+you checked the DNS configuration and you have access in HTTP to your server
+from outside your local network, then you can :
-```bash
-sudo mkdir yunohost_self_signed
-sudo mv *.pem *.cnf yunohost_self_signed/```
-
-Depends on the CA, intermediate certificates and root have to be downloaded.
-
-> **StartSSL**
-> ```bash
-> sudo wget http://www.startssl.com/certs/ca.pem -O ae_certs/ca.pem
-> sudo wget http://www.startssl.com/certs/sub.class1.server.ca.pem -O ae_certs/intermediate_ca.pem```
-
-> **Gandi**
-> ```bash
-> sudo wget https://www.gandi.net/static/CAs/GandiStandardSSLCA.pem -O ae_certs/intermediate_ca.pem```
-
-> **RapidSSL**
-> ```bash
-> sudo wget https://knowledge.rapidssl.com/library/VERISIGN/INTERNATIONAL_AFFILIATES/RapidSSL/AR1548/RapidSSLCABundle.txt -O ae_certs/intermediate_ca.pem```
-
-> **Cacert**
-> ```bash
-> sudo wget http://www.cacert.org/certs/root.crt -O ae_certs/ca.pem
-> sudo wget http://www.cacert.org/certs/class3.crt -O ae_certs/intermediate_ca.pem```
-
-Intermediate certificates and root must be merged with certificates obtained to create a unified chain certificates.
-
-```bash
-cat ae_certs/ssl.crt ae_certs/intermediate_ca.pem ae_certs/ca.pem | sudo tee crt.pem```
-
-
-The private key have to be converted in PEM format.
-
-```bash
-sudo openssl rsa -in ae_certs/ssl.key -out key.pem -outform PEM```
-
-Check certificates syntaxe, check file contents.
-
-```bash
-cat crt.pem key.pem```
-
-Certificates and private key look like this :
-
-`-----BEGIN CERTIFICATE-----`
-`MIICVDCCAb0CAQEwDQYJKoZIhvcNAQEEBQAwdDELMAkGA1UEBhMCRlIxFTATBgNV`
-`BAgTDENvcnNlIGR1IFN1ZDEQMA4GA1UEBxMHQWphY2NpbzEMMAoGA1UEChMDTExC`
-`MREwDwYDVQQLEwhCVFMgSU5GTzEbMBkGA1UEAxMSc2VydmV1ci5idHNpbmZvLmZy`
-`MB4XDTA0MDIwODE2MjQyNloXDTA0MDMwOTE2MjQyNlowcTELMAkGA1UEBhMCRlIx`
-`FTATBgNVBAgTDENvcnNlIGR1IFN1ZDEQMA4GA1UEBxMHQWphY2NpbzEMMAoGA1UE`
-`ChMDTExCMREwDwYDVQQLEwhCVFMgSU5GTzEYMBYGA1UEAxMPcHJvZi5idHNpbmZv`
-`LmZyMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDSUagxPSv3LtgDV5sygt12`
-`kSbN/NWP0QUiPlksOkF2NkPfwW/mf55dD1hSndlOM/5kLbSBo5ieE3TgikF0Iktj`
-`BWm5xSqewM5QDYzXFt031DrPX63Fvo+tCKTQoVItdEuJPMahVsXnDyYHeUURRWLW`
-`wc0BzEgFZGGw7wiMF6wt5QIDAQABMA0GCSqGSIb3DQEBBAUAA4GBALD640iwKPMf`
-`pqdYtfvmLnA7CiEuao60i/pzVJE2LIXXXbwYjNAM+7Lov+dFT+b5FcOUGqLymSG3`
-`kSK6OOauBHItgiGI7C87u4EJaHDvGIUxHxQQGsUM0SCIIVGK7Lwm+8e9I2X0G2GP`
-`9t/rrbdGzXXOCl3up99naL5XAzCIp6r5`
-`-----END CERTIFICATE-----`
-
-At last, secure files of your certificate
-
-```bash
-sudo chown root:metronome crt.pem key.pem
-sudo chmod 640 crt.pem key.pem
-sudo chown root:root -R ae_certs
-sudo chmod 600 -R ae_certs```
-
-Reload Nginx configuration to take into account the new certificate.
-
-```bash
-sudo service nginx reload```
-
-Your certificate is ready to serve. You can check that every thing is correct byan external service like geocerts
+- add a line `127.0.0.1 your.domain.tld` to the file `/etc/hosts` on your server ;
+- if the certificate installation still doesn't work, you can disable the checks with `--no-checks` after the `cert-install` command.
diff --git a/certificate_custom_fr.md b/certificate_custom_fr.md
new file mode 100644
index 00000000..86ebcd14
--- /dev/null
+++ b/certificate_custom_fr.md
@@ -0,0 +1,117 @@
+**Note :** depuis la version 2.5, Yunohost intègre la gestion automatisée de certificats Let's Encrypt. Vous pouvez donc facilement et gratuitement [installer un certificat Let's Encrypt](certificate_fr). Le document suivant décrit la méthodologie pour installer un certificat, payant, d'une autre autorité de certification (**Gandi**, **RapidSSL**, **StartSSL**, **Cacert**).
+
+### Ajout d’un certificat signé par une autorité (autre que Let's Encrypt)
+
+Après création du certificat auprès de votre autorité d’enregistrement, vous devez être en possession d’une clé privée, le fichier key et d’un certificat public, le fichier crt.
+> Attention, le fichier key est très sensible, il est strictement personnel et doit être très bien sécurisé.
+
+Ces deux fichiers doivent être copiés sur le serveur, s’ils ne s’y trouvent pas déjà.
+```bash
+scp CERTIFICAT.crt admin@DOMAIN.TLD:ssl.crt
+scp CLE.key admin@DOMAIN.TLD:ssl.key
+```
+
+Depuis Windows, scp est exploitable avec putty, en téléchargeant l’outil [pscp](http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe)
+
+```bash
+pscp -P 22 CERTIFICAT.crt admin@DOMAIN.TLD:ssl.crt
+pscp -P 22 CLE.key admin@DOMAIN.TLD:ssl.key
+```
+
+Dès lors que les fichiers sont sur le serveur, le reste du travail se fera sur celui-ci. En [ssh](https://yunohost.org/#/ssh_fr) ou en local.
+
+Tout d’abord, créez un dossier pour stocker les certificats obtenus.
+
+```bash
+sudo mkdir /etc/yunohost/certs/DOMAIN.TLD/ae_certs
+sudo mv ssl.key ssl.crt /etc/yunohost/certs/DOMAIN.TLD/ae_certs/
+```
+
+Puis allez dans le dossier parent pour poursuivre.
+
+```bash
+cd /etc/yunohost/certs/DOMAIN.TLD/
+```
+
+Faites une sauvegarde des certificats d’origine de yunohost, par précaution.
+
+```bash
+sudo mkdir yunohost_self_signed
+sudo mv *.pem *.cnf yunohost_self_signed/
+```
+
+En fonction de l’autorité d’enregistrement, des certificats intermédiaires et racines doivent être obtenus.
+
+> **StartSSL**
+> ```bash
+> sudo wget http://www.startssl.com/certs/ca.pem -O ae_certs/ca.pem
+> sudo wget http://www.startssl.com/certs/sub.class1.server.ca.pem -O ae_certs/intermediate_ca.pem
+>```
+
+> **Gandi**
+> ```bash
+> sudo wget https://www.gandi.net/static/CAs/GandiStandardSSLCA2.pem -O ae_certs/intermediate_ca.pem
+>```
+
+> **RapidSSL**
+> ```bash
+> sudo wget https://knowledge.rapidssl.com/library/VERISIGN/INTERNATIONAL_AFFILIATES/RapidSSL/AR1548/RapidSSLCABundle.txt -O ae_certs/intermediate_ca.pem
+>```
+
+> **Cacert**
+> ```bash
+> sudo wget http://www.cacert.org/certs/root.crt -O ae_certs/ca.pem
+> sudo wget http://www.cacert.org/certs/class3.crt -O ae_certs/intermediate_ca.pem
+>```
+
+Les certificats intermédiaires et root doivent être réunis avec le certificat obtenu pour créer une chaîne de certificats unifiés.
+
+```bash
+cat ae_certs/ssl.crt ae_certs/intermediate_ca.pem ae_certs/ca.pem | sudo tee crt.pem
+```
+
+La clé privée doit être, elle, convertie au format pem.
+
+```bash
+sudo openssl rsa -in ae_certs/ssl.key -out key.pem -outform PEM
+```
+
+Afin de s’assurer de la syntaxe des certificats, vérifiez le contenu des fichiers.
+
+```bash
+cat crt.pem key.pem
+```
+
+Les certificats et la clé privée doivent ressembler à cela :
+
+`-----BEGIN CERTIFICATE-----`
-Cet écran revient à demander **« Avez-vous confiance au serveur qui héberge ce site ? »**.
+Cet écran revient à demander **« Avez-vous confiance au serveur qui héberge ce site ? »**.
Cela peut effrayer vos utilisateurs (à juste titre).
-Pour éviter cette confusion, il est possible d’obtenir un certificat signé par une autorité « connue » : **Gandi**, **RapidSSL**, **StartSSL**, **Cacert**.
-Dans ce cas, il s’agira de remplacer le certificat auto-signé par celui qui a été reconnu par une autorité de certification, et vos utilisateurs n’auront plus à passer par cet écran d’avertissement.
+Pour éviter cette confusion, il est possible d’obtenir un certificat, reconnu directement par les navigateurs, signé par une autorité « connue » : **Let's Encrypt**, **Gandi**, **RapidSSL**, **StartSSL**, **Cacert**.
-### Ajout d’un certificat signé par une autorité
+**Let's Encrypt** propose des certificats gratuits. Depuis la version 2.5, YunoHost permet d'installer directement un tel certificat depuis l'interface d'administration ou la ligne de commande. La suite du document détaille l'installation et la gestion d'un tel certificat. Vous pouvez également [installer un certificat d'une autre autorité que Let's Encrypt](/certificate_custom_fr).
-Après création du certificat auprès de votre autorité d’enregistrement, vous devez être en possession d’une clé privée, le fichier key et d’un certificat public, le fichier crt.
-> Attention, le fichier key est très sensible, il est strictement personnel et doit être très bien sécurisé.
+### Installer un certificat Let's Encrypt
-Ces deux fichiers doivent être copiés sur le serveur, s’ils ne s’y trouvent pas déjà.
+Avant de chercher à installer un certificat Let's Encrypt, assurez vous que
+votre DNS est correctement configuré (votre.domaine.tld doit pointer sur l'IP
+de votre serveur) et que votre site est accessible en HTTP depuis l'extérieur
+(i.e. qu'au moins le port 80 est correctement redirigé vers votre serveur).
+
+#### Via l'interface d'administration web
+
+Rendez-vous dans la partie 'Domaine' de l'interface d'administration, puis dans
+la section dédiée à votre domaine. Vous trouverez un bouton 'Certificat SSL'.
+
+
+
+Dans la section 'Certificat SSL', vous pourrez voir l'état actuel du certificat.
+Si vous venez d'ajouter le domaine, il dispose d'un certificat auto-signé.
+
+
+
+Si votre domaine est correctement configuré, il vous est alors possible de
+passer à un certificat Let's Encrypt via le bouton vert.
+
+
+
+Une fois l'installation effectuée, vous pouvez vous rendre sur votre domaine
+via votre navigateur, en HTTPS, pour vérifier que votre certificat est bien
+signé par Let's Encrypt. Le certificat sera renouvelé automatiquement tous les
+trois mois environ.
+
+
+
+#### Via la ligne de commande
+
+Connectez-vous sur votre serveur en SSH.
+
+Vous pouvez vérifier le statut actuel de votre certificat via
```bash
-scp CERTIFICAT.crt admin@DOMAIN.TLD:ssl.crt
-scp CLE.key admin@DOMAIN.TLD:ssl.key
+yunohost domain cert-status votre.domaine.tld
```
-Depuis Windows, scp est exploitable avec putty, en téléchargeant l’outil [pscp](http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe)
+Installez le certificat Let's Encrypt via
```bash
-pscp -P 22 CERTIFICAT.crt admin@DOMAIN.TLD:ssl.crt
-pscp -P 22 CLE.key admin@DOMAIN.TLD:ssl.key```
+yunohost domain cert-install votre.domaine.tld
+```
-Dès lors que les fichiers sont sur le serveur, le reste du travail se fera sur celui-ci. En [ssh](https://yunohost.org/#/ssh_fr) ou en local.
-
-Tout d’abord, créez un dossier pour stocker les certificats obtenus.
+Cette commande doit retourner :
```bash
-sudo mkdir /etc/yunohost/certs/DOMAIN.TLD/ae_certs
-sudo mv ssl.key ssl.crt /etc/yunohost/certs/DOMAIN.TLD/ae_certs/```
+Success! The SSOwat configuration has been generated
+Success! Successfully installed Let's Encrypt certificate for domain DOMAIN.TLD!
+```
-Puis allez dans le dossier parent pour poursuivre.
+Une fois l'installation effectuée, vous pouvez vous rendre sur votre domaine
+via votre navigateur, en HTTPS, pour vérifier que votre certificat est bien
+signé par Let's Encrypt. Le certificat sera renouvelé automatiquement tous les
+trois mois environ.
+
+##### En cas de problème
+
+Si suite à une mauvaise manipulation, un certificat se retrouve dans une
+situation fâcheuse (e.g. perte du certificat ou impossible de lire le
+certificat), il est possible de repartir sur des bases propres en regénérant un
+certificat auto-signé :
```bash
-cd /etc/yunohost/certs/DOMAIN.TLD/```
+yunohost domain cert-install votre.domaine.tld --self-signed --force
+```
-Faites une sauvegarde des certificats d’origine de yunohost, par précaution.
+Si YunoHost trouve que votre domaine est mal configuré quand bien même vous
+avez bien vérifié votre configuration DNS et avez bien accès à votre serveur en
+HTTP depuis l'extérieur, vous pouvez tenter :
-```bash
-sudo mkdir yunohost_self_signed
-sudo mv *.pem *.cnf yunohost_self_signed/```
-
-En fonction de l’autorité d’enregistrement, des certificats intermédiaires et racines doivent être obtenus.
-
-> **StartSSL**
-> ```bash
-> sudo wget http://www.startssl.com/certs/ca.pem -O ae_certs/ca.pem
-> sudo wget http://www.startssl.com/certs/sub.class1.server.ca.pem -O ae_certs/intermediate_ca.pem```
-
-> **Gandi**
-> ```bash
-> sudo wget https://www.gandi.net/static/CAs/GandiStandardSSLCA.pem -O ae_certs/intermediate_ca.pem```
-> Attention si votre certificat expire après le 01/01/2017, choisissez le certificat intermédiaire SHA2 suivant (à la place du certificat SHA1 précédent)
-> ```bash
-> sudo wget https://www.gandi.net/static/CAs/GandiStandardSSLCA2.pem -O ae_certs/intermediate_ca.pem```
-
-> **RapidSSL**
-> ```bash
-> sudo wget https://knowledge.rapidssl.com/library/VERISIGN/INTERNATIONAL_AFFILIATES/RapidSSL/AR1548/RapidSSLCABundle.txt -O ae_certs/intermediate_ca.pem```
-
-> **Cacert**
-> ```bash
-> sudo wget http://www.cacert.org/certs/root.crt -O ae_certs/ca.pem
-> sudo wget http://www.cacert.org/certs/class3.crt -O ae_certs/intermediate_ca.pem```
-
-Les certificats intermédiaires et root doivent être réunis avec le certificat obtenu pour créer une chaîne de certificats unifiés.
-
-```bash
-cat ae_certs/ssl.crt ae_certs/intermediate_ca.pem ae_certs/ca.pem | sudo tee crt.pem```
-
-La clé privée doit être, elle, convertie au format pem.
-
-```bash
-sudo openssl rsa -in ae_certs/ssl.key -out key.pem -outform PEM```
-
-Afin de s’assurer de la syntaxe des certificats, vérifiez le contenu des fichiers.
-
-```bash
-cat crt.pem key.pem```
-
-Les certificats et la clé privée doivent ressembler à cela :
-
-`-----BEGIN CERTIFICATE-----`
-`MIICVDCCAb0CAQEwDQYJKoZIhvcNAQEEBQAwdDELMAkGA1UEBhMCRlIxFTATBgNV`
-`BAgTDENvcnNlIGR1IFN1ZDEQMA4GA1UEBxMHQWphY2NpbzEMMAoGA1UEChMDTExC`
-`MREwDwYDVQQLEwhCVFMgSU5GTzEbMBkGA1UEAxMSc2VydmV1ci5idHNpbmZvLmZy`
-`MB4XDTA0MDIwODE2MjQyNloXDTA0MDMwOTE2MjQyNlowcTELMAkGA1UEBhMCRlIx`
-`FTATBgNVBAgTDENvcnNlIGR1IFN1ZDEQMA4GA1UEBxMHQWphY2NpbzEMMAoGA1UE`
-`ChMDTExCMREwDwYDVQQLEwhCVFMgSU5GTzEYMBYGA1UEAxMPcHJvZi5idHNpbmZv`
-`LmZyMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDSUagxPSv3LtgDV5sygt12`
-`kSbN/NWP0QUiPlksOkF2NkPfwW/mf55dD1hSndlOM/5kLbSBo5ieE3TgikF0Iktj`
-`BWm5xSqewM5QDYzXFt031DrPX63Fvo+tCKTQoVItdEuJPMahVsXnDyYHeUURRWLW`
-`wc0BzEgFZGGw7wiMF6wt5QIDAQABMA0GCSqGSIb3DQEBBAUAA4GBALD640iwKPMf`
-`pqdYtfvmLnA7CiEuao60i/pzVJE2LIXXXbwYjNAM+7Lov+dFT+b5FcOUGqLymSG3`
-`kSK6OOauBHItgiGI7C87u4EJaHDvGIUxHxQQGsUM0SCIIVGK7Lwm+8e9I2X0G2GP`
-`9t/rrbdGzXXOCl3up99naL5XAzCIp6r5`
-`-----END CERTIFICATE-----`
-
-Enfin, sécurisez les fichiers de votre certificat.
-
-```bash
-sudo chown root:metronome crt.pem key.pem
-sudo chmod 640 crt.pem key.pem
-sudo chown root:root -R ae_certs
-sudo chmod 600 -R ae_certs```
-
-Rechargez la configuration de nginx pour prendre en compte le nouveau certificat.
-```bash
-sudo service nginx reload```
+- d'ajouter une ligne `127.0.0.1 votre.domaine.tld` au fichier `/etc/hosts` sur votre serveur ;
+- si l'installation ne fonctionne toujours pas, désactiver les vérifications en ajoutant `--no-checks` à la commande `cert-install`.
-Votre certificat est prêt à servir. Vous pouvez toutefois vous assurez de sa mise en place en testant le certificat à l’aide du service de geocerts.
diff --git a/certmanager.md b/certmanager.md
index 99872bb3..70ce239f 100644
--- a/certmanager.md
+++ b/certmanager.md
@@ -15,7 +15,7 @@ command line with `yunohost domain cert-status`, `cert-install` and
Your server needs to be reachable from the rest of Internet on port 80 (and
443), and make your `domain.tld` points to your server's public IP in your DNS
-configuration. See [this documentation](hdiagnostic) if you need help.
+configuration. See [this documentation](diagnostic_en) if you need help.
#### Will my certificate be automatically be renewed ?
diff --git a/certmanager_fr.md b/certmanager_fr.md
index 7b38c0ef..80273647 100644
--- a/certmanager_fr.md
+++ b/certmanager_fr.md
@@ -127,7 +127,7 @@ deux choses :
- la confidentialité, ce qui veut dire qu'un attaquant ne sera pas capable de déchiffrer le contenu d'une communication si elle est interceptée ;
- l'identification du serveur, ce qui veut dire qu'un serveur peut et doit prouver qui il prétend être, dans le but d'éviter les [attaques man-in-the-middle](https://en.wikipedia.org/wiki/Man-in-the-middle_attack).
-Les certificats SSL sont utilisés par les serveurs pour prouver leur identitié.
+Les certificats SSL sont utilisés par les serveurs pour prouver leur identité.
Le processus général repose sur la confiance en des tiers, appelés Autorité
de Certification (CA), dont le rôle est de vérifier l'identité d'un serveur (par ex.
qu'une machine donnée contrôle bien le domaine `jaimelecafe.com`) avant
diff --git a/change_admin_password_fr.md b/change_admin_password_fr.md
index 56cd7c95..3554ba80 100644
--- a/change_admin_password_fr.md
+++ b/change_admin_password_fr.md
@@ -18,3 +18,9 @@ Puis allez dans la section `Outils` > `Changer le mot de passe d’administratio
```bash
yunohost tools adminpw
```
+
+Si vous avez oublié votre mot de passe, utilisez plutôt:
+
+```bash
+yunohost-reset-ldap-password
+```
diff --git a/changelog_2_0.md b/changelog_2_0.md
deleted file mode 100644
index 951f07dd..00000000
--- a/changelog_2_0.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# Changelog 2.0
-
-2.0 2.2 Roadmap
-
-## v2.0 12 june 2014
-* ✔ Add sexiness and a menu to YunoHost.org frontpage *(kload)*
-* ✔ **DOCUMENTATIONNNNNNN** *(everyone <3)*
-
----
-
-## v2.0 RC
-
-* ✔ Email forward configuration *(kload, beudbeud)*
-* ✔ Make pending official apps *(Ju)*
-* ✔ SFTP *(kload)*
-* ✔ Fix DNS zone *(kload)*
-* ✔ SSOwat stuffs (presistent rules, public root website) *(ezpen)*
-* ✔ Email configuration tests *(beudbeud)*
-* ✔ Test and upgrade official apps like Owncloud, Roundcube and Radicale *(app maintainers)*
-* ✔ Upgrade function + view *(beudbeud, opi)*
-* ✔ uPnP rework *(kload, titoko)*
-* ✔ Add warning in a sample backup view *(opi)*
-* ✔ User interface design *(Courgette, opi)*
-* ✔ Moulinette/API refactoring *(jerome)*
-* ✔ Security check and complete patterns
-* ✔ Internationalization I18n *(opi, jerome)*
-* ✔ Lack of hairpinning hack *(kload)*
\ No newline at end of file
diff --git a/changelog_2_2.md b/changelog_2_2.md
deleted file mode 100644
index aad69cf1..00000000
--- a/changelog_2_2.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# Changelog 2.2
-
-2.0 2.2 Roadmap
-
-## v2.2 12 may 2015
-Core:
-* ✔ Migrate YunoHost to Debian Jessie
-* ✔ Update Metronome to v3.6 and make a more Debian-friendly package *(jerome)*
-* ✔ Update of Nginx, Postfix and Dovecot regarding the late Poodle attack
-* ✔ Migrate Bind9 to Dnsmasq *(kload)*
-* ✔ Add email quota *(beudbeud, jerome)*
-* ✔ Implement a simple backup and restore system *(jerome, kload)*
-* ✔ Add logging to the moulinette for each action *(jerome)*
-* ✔ Review the app manifest format and integrate it *(app maintainers, jerome, opi)*
-* ✔ Fix a security bug in SSOwat *(kload)*
-
-Web administration:
-* ✔ Install unofficial apps *(opi)*
-* ✔ Add firewall *(opi)*
-* ✔ Warn admin about security updates *(opi)*
-* ✔ Fix websocket issue for Raspberry Pi *(jerome, kload)*
-
-Apps:
-* ✔ 21 official apps and 88 unofficial apps *(app maintainers)*
-* ✔ Migrate to Baikal and deprecate Radicale *(ju)*
-* ✔ Add Shell in a box and remove GateOne from official apps *(kload)*
-* ✔ OpenVPN configuration page and access control *(kload)*
-* ✔ Add a download files button on Transmission interface *(opi)*
-
-Installs:
-* ✔ Create an image for La Brique Internet on Olimex *(kload)*
-* ✔ Create an image for Raspberry Pi 1 and 2 *(matlink)*
-* ✔ Create an image for Cubieboard 2 *(Moul)*
-* ✔ Update Docker image *(kload)*
-
-Others:
-* ✔ Install and switch to a new build system on a new server *(beudbeud)*
-* ✔ Improve documentation, to make YunoHost more accessible *(Moul)*
\ No newline at end of file
diff --git a/chat_rooms.md b/chat_rooms.md
index bae801ed..d77f62e9 100644
--- a/chat_rooms.md
+++ b/chat_rooms.md
@@ -2,23 +2,33 @@
Amoung other communication tools, YunoHost project use chat rooms to communicate.
-This instant messaging chat rooms, which uses [XMPP protocol](XMPP_en), are hosted on our XMPP server.
+You could join those chat rooms using :
+- an [IRC Client](https://en.wikipedia.org/wiki/Comparison_of_Internet_Relay_Chat_clients) for example [kiwiirc](https://kiwiirc.com/client/irc.freenode.net/yunohost)
+- an [XMPP client](https://en.wikipedia.org/wiki/Comparison_of_instant_messaging_clients)
+- a [Matrix client](https://matrix.org/docs/guides/faq.html#what-clients-are-available%3F)
-You could join this chat rooms with an [XMPP client](https://en.wikipedia.org/wiki/Comparison_of_instant_messaging_clients#XMPP-related_features).
-### Chat rooms
-#### Mutual aid
-[Mutual aid](support_en) chat room is here to allow YunoHost's users to help each other.
+#### Help and support chatroom
-- A [web client](https://chat.yunohost.org) is here to easily join _mutual aid_ chat room.
-- **[support@conference.yunohost.org](xmpp:support@conference.yunohost.org?join)**
+There is a [support](support_fr) chatroom for YunoHost users mutual support and help.
-#### Development
-YunoHost core development chat room. Currently, the main chat room for contributions on YunoHost project.
-For help, thanks to do it on `support` chat room.
-- **[dev@conference.yunohost.org](xmpp:dev@conference.yunohost.org?join)**
+- IRC: **#yunohost** on irc.freenode.net ;
+- Matrix: **#freenode_#yunohost:matrix.org** ;
+- XMPP: **[support@conference.yunohost.org](xmpp:support@conference.yunohost.org?join)**
-#### Applications
+#### Development chatroom
+
+YunoHost core development chat room :
+- IRC: **#yunohost-dev** on irc.freenode.net ;
+- Matrix: **#freenode_#yunohost-dev:matrix.org** ;
+- XMPP: **[dev@conference.yunohost.org](xmpp:dev@conference.yunohost.org?join)**
+
+Currently, the main chat room for contributions on YunoHost project.
+For help, please see **#yunohost** chat room above.
+
+#### Applications chatroom
Application packaging development chat room. It allow packagers to help each other.
-It also allow to discuss packaging evolution, continuous integration tools.
-- **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)**
+It also allow to discuss packaging evolution, continuous integration tools :
+- IRC: **#yunohost-apps** on irc.freenode.net
+- Matrix: **#freenode_#yunohost-apps:matrix.org**
+- XMPP: **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)**
diff --git a/chat_rooms_fr.md b/chat_rooms_fr.md
index b7eaac70..5bcc631a 100644
--- a/chat_rooms_fr.md
+++ b/chat_rooms_fr.md
@@ -1,24 +1,31 @@
## Salons de discussions
-Parmi d’autres outils de communications, le projet YunoHost se sert de salons de discussions pour communiquer.
+Parmi d’autres outils, le projet YunoHost se sert de salons de discussions pour communiquer.
-Ces salons de messagerie instantanées, qui utilisent le [protocole XMPP](XMPP_fr), sont hébergés sur notre serveur XMPP.
+Vous pouvez rejoindre ces salons avec:
+- un [Client IRC](https://fr.wikipedia.org/wiki/Liste_de_clients_IRC)
+- un [Client XMPP](https://fr.wikipedia.org/wiki/Clients_XMPP)
+- un [Client Matrix](https://linuxfr.org/news/matrix-pour-decentraliser-skype-whatsapp-signal-slack-et-discord)
-Vous pouvez rejoindre ces salons avec un [client XMPP](https://fr.wikipedia.org/wiki/Liste_de_clients_XMPP).
-### Salons
-#### Entraide
-Salon d’[entraide](support_fr) est là pour permettre aux utilisateurs de YunoHost de s’entraider.
-
-- Un [client web](https://chat.yunohost.org) est à votre disposition pour rejoindre facilement le salon d’entraide.
-- **[support@conference.yunohost.org](xmpp:support@conference.yunohost.org?join)**
+#### Salon d'entraide et de support
+Le salon d’[entraide](support_fr) est là pour permettre aux utilisateurs de YunoHost de s'aider mutuellement.
+- IRC : **#yunohost** sur irc.freenode.net (voir kiwiirc ci-dessus)
+- Matrix : **#freenode_#yunohost:matrix.org**
+- XMPP : **[support@conference.yunohost.org](xmpp:support@conference.yunohost.org?join)**
#### Développement
-Salon de développement du cœur de YunoHost. Actuellement utilisé comme salon principal pour les contributions autour du projet.
-Pour de l’aide, merci de le faire sur le salon d’entraide.
-- **[dev@conference.yunohost.org](xmpp:dev@conference.yunohost.org?join)**
+Salon de développement du cœur de YunoHost:
+- IRC : **#yunohost-dev** sur irc.freenode.net
+- Matrix : **#freenode_#yunohost-dev:matrix.org**
+- XMP : **[dev@conference.yunohost.org](xmpp:dev@conference.yunohost.org?join)**
+
+C'est le salon principal pour les contributions autour du projet.
+Pour chercher de l’aide, merci d'aller sur le salon d’entraide ci-dessus.
#### Applications
Salon de développement du packaging d’application. Il permet aux packageurs de s’entraider.
Il sert également à discuter de l’évolution du packaging, des outils d’intégration continue sur les applications.
-- **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)**
+- IRC : **#yunohost-apps** sur irc.freenode.net
+- Matrix : **#freenode_#yunohost-apps:matrix.org**
+- XMPP : **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)**
diff --git a/check_logfile_fr.md b/check_logfile_fr.md
deleted file mode 100644
index b42ded0f..00000000
--- a/check_logfile_fr.md
+++ /dev/null
@@ -1,45 +0,0 @@
-## Consulter les fichiers de log du système
-
-### Accéder à un fichier de log
-#### Via l’interface d’administration
-[Administration web](admin_fr)
-
-#### En ligne de commande
-Un fichier de log est un simple fichier texte utilisé par certains programmes du système (et notamment les services) pour inscrire l’historique de leur fonctionnement. Consulter un fichier de log consiste donc à afficher son contenu pour lire les messages qui s’y trouvent.
-
-Pour accéder aux fichiers de log, la méthode traditionnelle consiste à [se connecter au serveur en ligne de commande via SSH](ssh_fr). Une fois connecté, utilisez la commande `tail` qui affiche uniquement la fin du fichier, car les fichiers de log sont très longs et qu’uniquement l’historique récent nous intéresse.
-
-### Services
-#### Courriel
-* Postfix
-* Dovecot
-* mail.log
-* amavis
-
-#### Serveur web
-* Nginx
-* php5-fpm
-
-#### Serveur XMPP metronome
-* Metronome
-
-#### Surveillance du serveur
-* Glances
-
-#### Bases de données
-* MySQL
-* Postgrey
-
-#### SSH
-
-#### yunohost-api
-
-#### Torrents
-* transmission-daemon
-
-#### LDAP
-* slapdStatut
-
-#### DNS
-* Dnsmasq
-* Bind9
\ No newline at end of file
diff --git a/collabora_fr.md b/collabora_fr.md
new file mode 100644
index 00000000..610e169b
--- /dev/null
+++ b/collabora_fr.md
@@ -0,0 +1,26 @@
+# Installer Collabora avec Nextcloud
+
+**Note :** la marche à suivre detaillée et realisée ici à partir d’une instance Yunohost sur Debian 8 (celle-ci n'a pas été testée suite a la migration sur la version 3 de Yunohost) et celle-ci part du principe que les domaines/sous-domaines sont correctement configurés au niveau des DNS et de votre instance Yunohost (voir [DNS](/dns_fr) , [DNS et installation d’une application sur un sous-domaine](/dns_subdomains_fr) ,[Configurer les enregistrements DNS](/dns_config_fr) et [Nom de domaine en noho.st / nohost.me](/dns_nohost_me_fr) )
+
+### Installer Nextcloud
+
+Si Nexcloud n'est pas déja installée sur votre instance Yunohost, vous pouvez l’installer depuis le lien suivant :
+
+[Installer nextcloud](https://install-app.yunohost.org/?app=nextcloud)
+
+
+### Installer l'application Collabora dans yunohost
+**dans l'interface d'Administration :**
+ Applications > Installer > En bas de la page _Installer une application personnalisée_ > Renseigner l’url « https://github.com/aymhce/collaboradocker_ynh » > Définir le nom de domaine secondaire/sous-domaine dédié à l'application Collabora .
+
+
+### Configuration dans nextcloud
+
+ **Ajouter l'application Collabora Online à Nextcloud :**
+
+ Cliquer sur l'icone de l'utilisateur en haut à droite > Applications > Bureautique & texte > Sous « Collabora Online » cliquer sur Activer
+
+**Configurer Collabora sur Nextcloud :**
+
+ Cliquer sur l'icone de l'utilisateur en haut à droite > Paramètres > Sous _Administration_, _Collabora en ligne_
+ Renseigner le « Serveur Collabora en ligne » par le nom de domaine choisi lors de l’installation de collabora dans yunohost (précédé de « https:// »).
diff --git a/moulinette.md b/commandline.md
similarity index 96%
rename from moulinette.md
rename to commandline.md
index f1a379d7..7e677489 100644
--- a/moulinette.md
+++ b/commandline.md
@@ -143,5 +143,11 @@ yunohost tools [-h] {postinstall,maindomain,ldapinit,adminpw} ...
postinstall YunoHost post-install
maindomain Main domain change tool
ldapinit YunoHost LDAP initialization
- adminpw Change admin password
+ adminpw Change admin password # Existing password required. See workaround below.
```
+
+
+### admin
+```bash
+yunohost-reset-ldap-password Reset the admin account (Web GUI) password
+```
\ No newline at end of file
diff --git a/moulinette_fr.md b/commandline_fr.md
similarity index 100%
rename from moulinette_fr.md
rename to commandline_fr.md
diff --git a/communication.md b/communication.md
index bd15befb..dcf9c190 100644
--- a/communication.md
+++ b/communication.md
@@ -1,5 +1,33 @@
# Communication
+
+## Talks / conf
+
+* (FR) [Capitole du libre 2017 - YunoHost : vers l'auto-hébergement et au-delà - JimboJoe](https://2017.capitoledulibre.org/programme/#yunohost-vers-lauto-hebergement-et-au-dela) ([slides](https://github.com/YunoHost/yunohost-cdl-2017/raw/master/YunoHost-CDL2017.pdf))
+* (FR) [PSES 2017 – Construire l’Internet du Futur avec YunoHost – Aleks, ljf](https://data.passageenseine.org/2017/aleks-ljf_internet-futur-yunohost.webm) ([slides](https://data.passageenseine.org/2017/aleks-ljf_internet-futur-yunohost.pdf))
+* (FR) [Université de technologie de compiègne 2017 – Agir pour un internet éthique – LJF](http://webtv.utc.fr/watch_video.php?v=O34AA7RBR1AH)
+* (EN) [FOSDEM 2017 – Internet Cube – kload](https://archive.fosdem.org/2017/schedule/event/internet_cube/)
+* (EN) [FOSDEM 2017 – YunoHost – Bram](https://archive.fosdem.org/2017/schedule/event/yunohost/)
+* (FR) [Capitole du libre 2016 – 1 an et ½ de Brique Internet – Bram](http://videos2016.capitoledulibre.org/communaute-du-libre/bram-1-an-et-demi-de-brique-internet.mp4)
+* (FR) [PSES 2015 - La Brique Internet](http://www.youtube.com/watch?v=NCRn0yRfkIE)
+* (FR) [THSF 2015 – beudbeud](https://vimeo.com/128055751)
+* (FR) [RMLL 2014 - Hébergez-vous ! – kload & beudbeud]()
+* (FR) [Capitole du libre 2013 - L’auto-hébergement pour tous avec YunoHost - beudbeud](http://2013.capitoledulibre.org/conferences/internet-libre/lauto-hebergement-pour-tous-avec-yunohost.html)
+* (EN) [FOSDEM 2013 — kload](https://www.youtube.com/watch?v=siN1OLAgGJk)
+
+## Articles / Press review
+
-
-* LinuxFr (french): [YunoHost 2.0 : self hosting at click range](https://linuxfr.org/news/yunohost-2-0-l-auto-hebergement-a-portee-de-clic)
-* Twitter [@yunohost](https://twitter.com/yunohost) [#yunohost](https://twitter.com/hashtag/yunohost?src=hash)
\ No newline at end of file
+
+
+
+* LinuxFr (french):
+ - [YunoHost 2.0 : self hosting at click range](https://linuxfr.org/news/yunohost-2-0-l-auto-hebergement-a-portee-de-clic)
+ - [Internet cube and YunoHost projects evolutions](https://linuxfr.org/news/evolutions-des-projets-la-brique-internet-et-yunohost-des-versions-2-2-2-4-et-2-5)
+- [Linux Pratique n°96 – YunoHost, l’auto-hébergement à portée de main – juillet 2016](http://connect.ed-diamond.com/Linux-Pratique/LP-096/YunoHost-l-auto-hebergement-a-portee-de-main)
+- [Linux Magazine n°208 – YunoHost, Personal server for a private cloud – Mars 2018](http://www.linux-magazine.com/Issues/2018/208/YunoHost)
+
+## YunoHost was cited in :
+
+* [EXPERIMENTA 2018](https://livestream.com/accounts/26482307/events/8034656/player?width=960&height=540&enableInfoAndActivity=true&defaultDrawer=&autoPlay=true&mute=false) at 57.47 (depuis https://www.experimenta.fr/direct/)
+* [Capitole du libre 2017 - « Contributopia », Dégoogliser ne suffit pas](https://www.youtube.com/watch?v=ip6_VMkWpr8&feature=youtu.be&t=4793)
+* [Contributopia - Essaimage (Framasoft)](https://contributopia.org/fr/essaimage/)
diff --git a/communication_fr.md b/communication_fr.md
deleted file mode 100644
index 7f3ab921..00000000
--- a/communication_fr.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# Communication
-
-
-
-* LinuxFr :
- - [YunoHost 2.0 : l’auto-hébergement à portée de clic](https://linuxfr.org/news/yunohost-2-0-l-auto-hebergement-a-portee-de-clic)
- - [Évolutions des projets La Brique Internet et YunoHost des versions 2.2, 2.4 et 2.5](https://linuxfr.org/news/evolutions-des-projets-la-brique-internet-et-yunohost-des-versions-2-2-2-4-et-2-5)
-* Twitter [@yunohost](https://twitter.com/yunohost) [#yunohost](https://twitter.com/hashtag/yunohost?src=hash)
-- [Linux Pratique n°96 – YunoHost, l’auto-hébergement à portée de main – juillet 2016](http://connect.ed-diamond.com/Linux-Pratique/LP-096/YunoHost-l-auto-hebergement-a-portee-de-main)
diff --git a/conf_fr.md b/conf_fr.md
deleted file mode 100644
index 5683a2c2..00000000
--- a/conf_fr.md
+++ /dev/null
@@ -1,10 +0,0 @@
-# Conférences
-
-- [Université de technologie de compiègne 2017 – Agir pour un internet éthique – LJF](http://webtv.utc.fr/watch_video.php?v=O34AA7RBR1AH)
-- [FOSDEM 2017 – YunoHost/Internet Cube – Bram/kload](https://video.fosdem.org/2017/AW1.125/)
-- [Capitole du libre 2016 – 1 an et ½ de Brique Internet – Bram](http://videos2016.capitoledulibre.org/communaute-du-libre/bram-1-an-et-demi-de-brique-internet.mp4)
-* [PSES 2015 - La Brique Internet](http://www.youtube.com/watch?v=NCRn0yRfkIE)
-* [THSF 2015 – beudbeud](https://vimeo.com/128055751)
-* [RMLL 2014 - Hébergez-vous ! – kload & beudbeud]()
-* [Capitole du libre 2013 - L’auto-hébergement pour tous avec YunoHost - beudbeud](http://2013.capitoledulibre.org/conferences/internet-libre/lauto-hebergement-pour-tous-avec-yunohost.html)
-* [FOSDEM 2013 — kload](https://www.youtube.com/watch?v=siN1OLAgGJk)
diff --git a/contribute.md b/contribute.md
index f09aaab3..bfedea13 100644
--- a/contribute.md
+++ b/contribute.md
@@ -22,7 +22,7 @@ Talk about software freedom, [self-hosting](selfhosting_en) and YunoHost to your
Testing
In any case, please [come to dev chatroom](xmpp:dev@conference.yunohost.org?join) to contribute :-)
- - diff --git a/contribute_ar.md b/contribute_ar.md new file mode 100644 index 00000000..499d5e56 --- /dev/null +++ b/contribute_ar.md @@ -0,0 +1,92 @@ +#+إنّ مصير واي يونوهوست YunoHost يُقرّره أناس و أنتم مِن بين هؤلاء +
+ +--- + +على أي حال تعالوا و انضموا إلى [غرفة المحادثة الخاصة بالمطوّرين](xmpp:dev@conference.yunohost.org?join) إن كنتم ترغبون في المساهمة :-)
+ diff --git a/contribute_fr.md b/contribute_fr.md index 28403815..4bffa7b4 100644 --- a/contribute_fr.md +++ b/contribute_fr.md @@ -22,7 +22,7 @@ Parlez de logiciel libre, d’[auto-hébergement](/selfhosting_fr), de YunoHost TestezDans tous les cas, venez sur le [salon de développement](xmpp:dev@conference.yunohost.org?join) pour contribuer :-)
- - diff --git a/contributordoc.md b/contributordoc.md index 3e01d50b..1dd5b2b1 100644 --- a/contributordoc.md +++ b/contributordoc.md @@ -1,12 +1,32 @@ # Contributor documentation -* [How to contribute](/contribute) -* [What is YunoHost](/whatsyunohost) - * Developement - * [Roadmap](/roadmap) - * [List of available applications](/apps) - * [Package new applications](/packaging_apps) - * [Develop on Docker](/docker) - * Documentation - * [Account creation to edit documentation](/accounting) - * [Write documentation](/write_documentation) +* [General ways of contributing to YunoHost](/contribute) +* [Writing documentation](/write_documentation) +* Application packaging + * [Apps wishlist](/apps_wishlist) + * [General introduction to app packaging](/packaging_apps_start) + * [Technical introduction to app packaging](/packaging_apps) + * [Setting up a dev environment with VirtualBox](packaging_apps_virtualbox_fr) + * [Manifest](packaging_apps_manifest) + * [Scripts](packaging_apps_scripts) + * [Arguments management](packaging_apps_arguments_management) + * [Nginx configuration](packaging_apps_nginx_conf) + * [Multi-instance](packaging_apps_multiinstance) + * [Helpers](packaging_apps_helpers) + * [Trap usage](packaging_apps_trap_fr) + * [Adding your app to the community list](https://github.com/YunoHost/Apps/#contributing) + * Quality tests + * [Package linter](https://github.com/YunoHost/package_linter) + * [Package check](https://github.com/YunoHost/package_check) + * [Applications levels](packaging_apps_levels_fr) + * [App Continuous Integration](https://ci-apps.yunohost.org/jenkins/) + * [App CI dashboard](https://dash.yunohost.org/appci/branch/stable) + * [YEP - YunoHost Enhancement Proposals](packaging_apps_guidelines_fr) +* [Contributing to the YunoHost core](/dev) + * [Setting up a dev environment with ynh-dev](https://github.com/YunoHost/ynh-dev/blob/master/README.md) + * [Deb build chain](https://github.com/YunoHost/vinaigrette/blob/master/README.md) + * Image building + * [x86 ISO](https://github.com/YunoHost/cd_build) + * [Raspberry Pi images](https://github.com/YunoHost/rpi-image) + * [Other ARM board images](https://github.com/YunoHost/arm-images) +* [Using the YunoHost API outside of the webadmin](/admin_api_fr) diff --git a/contributordoc_fr.md b/contributordoc_fr.md index 5ab59cc2..710d93d1 100644 --- a/contributordoc_fr.md +++ b/contributordoc_fr.md @@ -1,14 +1,33 @@ -# Documentation contributeur YunoHost +# Guide du contributeur -* [Guide du contributeur](/contribute_fr) -* [Qu’est-ce que YunoHost ?](/whatsyunohost_fr) - * Développement - * Feuille de route du projet - * [Liste des applications disponibles](/apps_fr) - * [Préparer/empaqueter une nouvelle application](/packaging_apps_fr) - * [Développer avec Docker](/docker_fr) - * [Présentation du fonctionnement de YunoHost](/package_list_fr) - * [Se créer un environnement de développement](/ynh_dev_fr) - * Documentation - * [Création d’un compte pour modifier la documentation](/accounting_fr) - * [Écrire de la documentation](/write_documentation_fr) +* [Liste des façons de contribuer à YunoHost](/contribute_fr) +* [Écrire de la documentation](/write_documentation_fr) +* Packaging d'application + * [Liste d'apps souhaitées par la communauté](/apps_wishlist_fr) + * [Introduction générale au packaging d'apps](/packaging_apps_start_fr) + * [Introduction technique au packaging d'apps](/packaging_apps_fr) + * [Déployer un environnement de développement avec VirtualBox](packaging_apps_virtualbox_fr) + * [Manifest](packaging_apps_manifest_fr) + * [Scripts](packaging_apps_scripts_fr) + * [Gestion des arguments](packaging_apps_arguments_management_fr) + * [Configuration nginx](packaging_apps_nginx_conf_fr) + * [Multi-instance](packaging_apps_multiinstance_fr) + * [Fonctions utiles](packaging_apps_helpers_fr) + * [Utilisation de 'trap'](packaging_apps_trap_fr) + * [Ajouter son application à la liste community](https://github.com/YunoHost/Apps/#contributing) + * Tests de qualité + * [Package linter](https://github.com/YunoHost/package_linter) + * [Package check](https://github.com/YunoHost/package_check) + * [Niveaux des applications](packaging_apps_levels_fr) + * [Intégration continue des apps](https://ci-apps.yunohost.org/jenkins/) + * [Tableau de bord du CI des apps](https://dash.yunohost.org/appci/branch/stable) + * [YEP - YunoHost Enhancement Proposals](packaging_apps_guidelines_fr) +* [Contribuer à la partie "core" de YunoHost](/dev_fr) + * [Déployer un environnement de dev avec ynh-dev](https://github.com/YunoHost/ynh-dev/blob/master/README.md) + * [Construction des paquets debian](https://github.com/YunoHost/vinaigrette/blob/master/README.md) + * [Feuilles de route du projet](https://github.com/YunoHost/issues/milestones?direction=asc&sort=title&state=open) + * Construction des images + * [x86 ISO](https://github.com/YunoHost/cd_build) + * [Images Raspberry Pi](https://github.com/YunoHost/rpi-image) + * [Autres images pour cartes ARM](https://github.com/YunoHost/arm-images) +* [Utiliser l'API YunoHost en dehors de la webadmin](/admin_api_fr) diff --git a/copy_image.md b/copy_image.md index 6cd22d68..c2312fb6 100644 --- a/copy_image.md +++ b/copy_image.md @@ -1,46 +1,46 @@ -# Copy an image to an SD card +# Flashing an SD card -Now that you have the YunoHost image, you have to copy its content to an SD card. -The process differs regarding your operating system. +Now that you download the YunoHost image, you have to copy its content to an SD +card. This step is also sometimes called 'flashing' the SD card. + +
-## On Windows
+### With Etcher
-* Download and install **[Win32 Disk Imager](http://sourceforge.net/projects/win32diskimager/)**
-* Plug your SD card in
-* Copy the `.img` file to your SD card using Win32 Disk Imager.
+Download Etcher for your
+operating system and install it.
-
+
-## On GNU/Linux, BSD or Mac OS
+Plug your SD card, select your YunoHost image and click "Flash"
-* Open a terminal
-* Plug your SD card in
-* Identify the device name by typing:
+### With `dd`
+
+If you are on Linux / Mac and know your way around command line, you may also
+flash your SD card with `dd`. You can identify which device corresponds to your
+SD card with `fdisk -l` or `lsblk`. Assuming your SD card is `/dev/mmcblk0` (be
+careful !!), you may run :
```bash
-sudo fdisk -l
+dd if=/path/to/yunohost.img of=/dev/mmcblk0
```
-It should be `/dev/diskN`, where `N` is a number, or `/dev/sdX`, where `X` is a letter.
-
-Carefull to not put the digit `N` cause it will create an [non-functional SD card](https://raspberrypi.stackexchange.com/questions/11880/sd-card-doesnt-works-after-dd).
-
-* Copy the image by typing:
-
-```bash
-sudo dd if=/path/to/your/.img of=/your/device/name
-```
-
- Do not forget to change `/path/to/your/.img` and `/your/device/name` with the appropriate values.
-
-The command may take a few minutes, then your SD card will be ready to use. **:-)**
-
## Expand the root partition (optional)
+
diff --git a/copy_image_fr.md b/copy_image_fr.md
index 25896d7f..f2e0509a 100644
--- a/copy_image_fr.md
+++ b/copy_image_fr.md
@@ -1,45 +1,51 @@
-# Copier l’image sur une carte SD
+# Flasher une carte SD
-Maintenant que vous avez l’image ISO YunoHost, vous devez la copier sur une carte SD. Le processus est différent suivant votre système d’exploitation.
+Maintenant que vous avez téléchargé l'image de YunoHost, il vous faut copier son
+contenu sur une carte SD. Cette étape est aussi souvent appelé 'flasher' la
+carte SD.
+
+
-## Sous Windows
+### Avec Etcher
-* Téléchargez et installez **[Win32 Disk Imager](http://sourceforge.net/projects/win32diskimager/)**.
-* Insérez votre carte SD.
-* Copiez le fichier `.img` sur votre carte SD en utilisant *Win32 Disk Imager*.
+Télécharger Etcher pour votre
+système d'exploitation, et installez-le.
-
+
-## Sous GNU/Linux, BSD ou Mac OS
+Connectez votre carte SD, sélectionnez votre image YunoHost, puis cliquez sur
+'Flash'.
-* Ouvrez un terminal.
-* Insérez votre carte SD.
-* Identifiez votre matériel en tapant :
+### Avec `dd`
+
+Si vous êtes sous Linux / Mac et que vous être à l'aise avec la ligne de
+commande, vous pouvez aussi flasher votre carte SD avec `dd`. Commencez par
+identifier le périphérique correspondant à votre carte SD avec `fdisk -l` ou
+`lsblk`. En supposant que votre carte SD soit `/dev/mmcblk0` (faites attention
+!), vous pouvez lancer :
```bash
-sudo fdisk -l
+dd if=/chemin/vers/yunohost.img of=/dev/mmcblk0
```
-Ça devrait être `/dev/diskN`, où `N` est un chiffre, ou `/dev/sdX`, où `X` est une lettre, ou `/dev/mmcblk0`.
+## Étendre la partition root (optionnel)
-Attention à ne pas mettre le chiffre `N` car ça créera une [carte SD non fonctionnelle](https://raspberrypi.stackexchange.com/questions/11880/sd-card-doesnt-works-after-dd).
+
diff --git a/create_live_usb.md b/create_live_usb.md
index f595e093..2a59c1dd 100644
--- a/create_live_usb.md
+++ b/create_live_usb.md
@@ -1,5 +1,8 @@
# Create a YunoHost Live ISO
+List of all pages of the web site
-+دليل واي يونوهوست YunoHost يرتكز أساسًا على ثلاثة محاور : +
+ +كل ما يخص طريقة استخدام السيرفر يوميًا
+يتطرق إلى طريقة التنصيب و إدارة السيرفر و التطبيقات
+يحتوي على كافة المعلومات التي تخصنا و أسلوب عملنا و مساهمتنا
+Liste de toutes les pages du site
-
Configure Mozilla Thunderbird (on a desktop computer)
-#### Mozilla Thunderbird
+The automatic detection tool of Thunderbird does not work yet with YunoHost. You will need to set it up manually. To do so, add the account information, then select port 993 with SSL/TLS for IMAP, and port 587 with STARTTLS for SMTP. Afterwards select 'Normal Password' for Authentication and click on 'Advanced Config'. You will need to accept the certificate exceptions for fetching mails and after you send your first mail. Don't forget to remove the dot before the domain name.
-The automatic detection tool of Thunderbird does not work with YunoHost. You will need to set it up manually. To do so, add the account information, then select SSL/TLS for IMAP and SMTP. Afterwards select 'Normal Password' for Authentication and click on 'Advanced Config'. You will need to accept the certificate exceptions for fetching mails and after you send your first mail. Remove dot before domain name.
-
-
+
+
* [Manage alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
-#### For Android
-[K-9 Mail](https://en.wikipedia.org/wiki/K-9_Mail) application works.
+### 
Configure K-9 Mail (on Android)
-#### For Firefox OS
+Follow the following steps. (As for thunderbird, you might need to accept certificates at some points)
-Tested with Firefox OS 2.6.
-On the home screen, enter the user name and the email address. Then use manual configuration:
-
-
-
-Configure manually the form as shown on following screenshots:
-
-
-
-
-
+
+
+
+
diff --git a/email_configure_client_fr.md b/email_configure_client_fr.md
index 89eae011..af527712 100644
--- a/email_configure_client_fr.md
+++ b/email_configure_client_fr.md
@@ -1,40 +1,28 @@
-## Configuration client email de bureau
+## Configuration desktop email client
-*[Documentation en rapport avec l’email de YunoHost](/email_fr)*.
+Vous pouvez récupérer et envoyer des emails avec votre instance YunoHost grâce à des logiciels comme Mozilla Thunderbird, ou sur votre smartphone grâce à des applications comme K-9 Mail.
-Il est possible d’accéder à ses emails grâce à un client lourd de messagerie électronique tel que Mozilla Thunderbird.
+##### Réglages génériques
-#### Prérequis
-* Adresse email principale
-* Mot de passe du compte utilisateur
+| Protocole | Port | Chiffrement | Authentification | Login |
+| :--: | :-: | :--: | :--: | :--: |
+| IMAP | 993 | SSL/TLS | Mot de passe normal | `nom_dutilisateur` (sans `@domain.tld`) |
+| SMTP | 587 | STARTTLS | Mot de passe normal | `nom_dutilisateur` (sans `@domain.tld`) |
-#### Réglages génériques
-| Protocole | Port | Chiffrement |
-| :--: | :-: | :--: |
-| IMAP | 993 | SSL/TLS |
-| SMTP | 465 | SSL/TLS |
+### Configurer Mozilla Thunderbird
-#### Mozilla Thunderbird
-L’utilitaire de détection automatique de Thunderbird ne fonctionne pas avec le serveur email de YunoHost. Il faut donc passer en configuration manuelle. N’oubliez pas d’enlever le point devant le nom de domaine.
+L'outil de détection automatique de Thunderbird ne fonctionne actuellement pas avec YunoHost. Il vous faudra remplir les champs manuellement. Commencez par remplir les informations de base (Nom, adresse et mot de passe), cliquez sur Continuer puis Configuration Manuelle. Enlevez le `.` avant le nom de domaine. Sélectionnez le port 993 avec SSL/TLS pour IMAP, et le port 587 avec STARTTLS pour SMTP. Sélectionnez 'Mot de passe normal' pour l'authentification. Testez la configuration puis validez. (Il vous faudra ensuite possiblement accepter des certificats pour que tout fonctionne correctement.)
-
+
+
-* [Gestion des alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
+* [Gérer les alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
-#### Pour Android
-L’application [K-9 Mail](https://github.com/k9mail) fonctionne.
+### Configurer K-9 Mail (sur Android)
+Suivez les instructions suivantes. (Comme pour Thunderbird, il vous faudra peut-être accepter des certificats à un moment)
-#### Pour Firefox OS
-
-Testé avec Firefox OS 2.6.
-Sur la page d’accueil, entrez votre nom d’utilisateur et l’adresse email, puis allez dans la configuration manuelle :
-
-
-
-Configurer manuellement le formulaire comme indiqué sur les captures d’écran suivantes :
-
-
-
-
-
+
+
+
+
diff --git a/email_fr.md b/email_fr.md
index 237e3408..93ea96de 100644
--- a/email_fr.md
+++ b/email_fr.md
@@ -17,7 +17,7 @@ Suivez [ce guide](email_migration_fr) pour transférer vos
Si vous avez opté pour un nom de domaine personnel, il est nécessaire de [configurer votre serveur DNS](/dns_config_fr) pour faire fonctionner la messagerie électronique.
#### Ouverture des ports
-Vérifiez également que les ports correspondant à la messagerie (n° 25, 465 et 993) sont bien ouverts au niveau de votre box ou de votre routeur. [Tutoriel d’ouverture des ports de la box](/isp_box_config_fr).
+Vérifiez également que les ports correspondant à la messagerie (n° 25, 587 et 993) sont bien ouverts au niveau de votre box ou de votre routeur. [Tutoriel d’ouverture des ports de la box](/isp_box_config_fr).
#### Configurer l’authentification DKIM/SPF (facultatif)
Le protocole SMTP ne prévoit pas de mécanisme de vérification de l’expéditeur. Il est donc possible d’envoyer un courrier avec une adresse d’expéditeur factice ou usurpée. SPF et DKIM sont deux mécanismes possibles d’authentification de l’expéditeur d’un email. [Tutoriel pour configurer DKIM/SPF](dkim_fr).
@@ -27,10 +27,28 @@ Le protocole SMTP ne prévoit pas de mécanisme de vérification de l’expédit
Si les courriels envoyés à un type d’adresse spécifique (par exemple les adresses Gmail) n’arrivent pas à destination, votre serveur (son adresse IP) a peut être été ajouté à la liste noire du fournisseur d’adresse courriel en question. Pour résoudre ce problème voici les [formulaires de retrait des listes noires](blacklist_forms_fr).
#### Consulter les fichiers de log pour identifier le problème
-De nombreux messages permettant d’identifier les problèmes se trouvent enregistrés dans les fichiers de log du système. [Apprenez à les consulter](check_logfile_fr), pour pouvoir mieux comprendre ce qui cloche et trouver de l’aide sur le forum ou le salon de support.
+De nombreux messages permettant d’identifier les problèmes se trouvent enregistrés dans les fichiers de log du système. Apprenez à les consulter, pour pouvoir mieux comprendre ce qui cloche et trouver de l’aide sur le forum ou le salon de support.
+#### Je suis capable de recevoir mais pas d'envoyer des mails
+
+Cela peut être dû au fait que le port 25 est fermé, et que votre fournisseur d'accès internet ne vous permet pas de l'ouvrir (pour lutter contre le spam)...
+
+Une solution de contournement consiste, soit à utiliser un VPN (ce qui nécessitera un abonnement chez un fournisseur, et de configurer l'app vpnclient), soit à utiliser un relai SMTP.
+
+Attention : dans le cas d'un relai SMTP, ***la personne ou l'organisme qui possède le relai sera techniquement très facilement capable de lire tout mail non-chiffré transitant entre votre serveur et le reste d'Internet ! Vous lui faites donc confiance à propos de toute information personelle ou critique que pourrait contenir vos mails !***
+
+Pour mettre en place le relai SMTP, il faut modifier le fichier `/etc/postfix/main.cf`.
+Chercher la ligne contenant `relayhost = ` et la remplacer par `relayhost = smtp.If you care about distrowars, or think 'Debian is dirty', you are not the public of YunoHost.
+ +YunoHost is aimed at non-tech people who just want their server to work. Debian has its flaws, but it's (one of?) the most widely known and used distribution for servers. It's stable. Most self-hosted softwares are one way or another compatible with Debian. It's easily hackable by anybody who's been doing a bit of CLI on their personal Ubuntu/Mint computer. There is no killer feature in other distributions that makes it relevant for YunoHost to switch or port it.
+ +If this does not convince you, there are other projects running on other distributions or with different philosophy.
+YunoHost aims to make packaging easy. The idea from the beginning was to keep it as simple as « if you can install the app manually, then you can easily copy/paste steps into a basic install/remove package with no particular training ». This is not the case with Debian packages.
+ +Turns out, YunoHost apps packaging holds a subtly different purpose than traditional packaging like .deb. Debian packages fulfill the low-level purpose of installing files, commands, programs and services on the system. It is often your duty to configure them properly, simply because there is no standard server setup. Typically, web apps requires a lot of configuration because they rely on a web server and a database (and the single sign-on).
+ +YunoHost manipulates high-level abstractions (apps, domains, users, ...) and defines a standard setup (Nginx, Postfix, Metronome, SSOwat, ...) and, because of this, can handle the configuration for the user.
+ +If you still think deb packages can be hacked to do this, see previous answers.
+Si vous vous préoccupez des guéguerres de distro, ou pensez que « Debian c’est sale », vous n’êtes pas le public de YunoHost.
+ +YunoHost vise un public de non-technophile ou de bidouilleurs qui veulent simplement que le serveur fonctionne sans devoir investir des semaines entières. Debian a probablement des défauts, mais c’est une (la ?) distribution la plus connue et utilisée pour gérer des serveurs. C’est une distribution stable. La plupart des services auto-hébergeables sont compatibles d’une manière ou d’une autre avec Debian. Elle est facilement bidouillable par quelqu’un qui a déjà utilisé la ligne de commande sur son ordinateur personnel. Il n’y a pas de « killer feature » particulière dans les autres distributions qui rendrait pertinent de porter YunoHost dessus.
+ +Si cela ne vous convient pas, il existe d’autres projets sous d’autres distributions ou avec d’autres philosophies.
+YunoHost cherche à garder un système de packaging simple. L’idée depuis le départ était que « si tu sais installer l’app à la main, alors tu peux facilement créer un package basique en copiant-collant les étapes, sans besoin de connaissances particulière ». Ce n’est pas le cas des paquets Debian.
+ +Il se trouve que l’objectif des paquets d’application YunoHost est subtilement différent des paquets traditionnels (comme les .deb de Debian) qui remplissent le rôle d’installer des éléments bas-niveaux tels que des fichiers, commandes, programmes ou services sur le système. Il est à la charge de l’administrateur de les configurer ensuite proprement, simplement parce qu’il n’existe pas d’environnement standard. Typiquement, les applications web requièrent beaucoup de configuration car elles ont besoin de s’interfacer avec un serveur web et une base de données (et le système de connexion unique / SSO).
+ +YunoHost manipule des abstractions haut-niveau (apps, domaines, utilisateurs…) et défini un environnement standard (Nginx, Postfix, Metronome, SSOwat…) et, grâce à cela, peut gérer la configuration à la place de l’administrateur.
+ +Si vous restez persuadé que l’on peut néanmoins bricoler les paquets .deb pour gérer tout cela, voir les réponses précédentes.
+
+ + تعالي إلى منزلي، أنا مُستضافة عند صديقة + إن لم تقم باستضافة نفسك بنفسك في عمر الخمسين فاعرف أنك قد فشلت في حياتك + فاستضافوا أنفسهم بأنفسم و كانت لهم ذرية كثيرة + الإنترنت، قراءة و كتابة + monsieur@michu.fr + ليس هناك ما أخفيه + كيف التقيتُ بالسيرفر الخاص بك +
+ +
+ 
+ 
+ 
+
+ 
+
+ + Selbst-Hosting für dich, Mom. + Hasser werden Gastgeber sein + Ich beherberge mich selbst, b*tches + Geh und bewirte dich! + Raus aus meiner Cloud + Beherbergt mich, ich bin berühmt. + Versuchen Internet + Wie kann I ich eure Server begegnen ? + john@doe.org + dude, Y U NO Host?! + Ruhe bewahren und sich selbst bewirten +
+ +
+
+
+
+
+
+
-On Debian 8/Jessie
+On Debian 9/Stretch
على فاغرانت
+
-Sur Debian 8/Jessie
+Sur Debian 9/Stretch
-
-
-
-
+
+
+
+
+
+على منصة ARM أو على خادوم إفتراضي خاص أو على خادوم إستضافة أو على حاسوب x86 عادي أو على حاسوب ماكينطوش قديم … إلخ
+
+* على **ديبيان 8** (جيسي) قد تم تنصيبه مِن قبل
+* مُتصل بالإنترنت عبر كابل إيثرنت
+* مباشرة عبر **النفاذ بالمستخدم الجذري root** أو عبر الـ SSH
+
+
+
+---
+
+## خطوات التنصيب
+
+1. التنصيب يدويًا
+
+2. ما بعد التنصيب
+
diff --git a/install_on_debian_fr.md b/install_on_debian_fr.md
index dbd61065..3f5ab9ad 100644
--- a/install_on_debian_fr.md
+++ b/install_on_debian_fr.md
@@ -8,8 +8,8 @@
Sur une plateforme ARM, un VPS, un serveur dédié, un ordinateur x86 standard, un vieux Macintosh,...
-* avec **Debian 8** (Jessie) d’installé
-* connecté à Internet avec un câble RJ-45
+* avec **Debian 9** (Stretch) installé
+* connecté à Internet
* avec un **accès root** directement ou par SSH
@@ -22,7 +22,3 @@ Sur une plateforme ARM, un VPS, un serveur dédié, un ordinateur x86 standard,
2. Post-installation
----
-
-***Si vous avez besoin d’aide lors de ces étapes, n’hésitez pas à utiliser les différents [moyens de support](/support_fr).***
-
diff --git a/install_on_olinuxino.md b/install_on_olinuxino.md
deleted file mode 100644
index 11487bc7..00000000
--- a/install_on_olinuxino.md
+++ /dev/null
@@ -1,111 +0,0 @@
-# Install on an OlinuXino board
-
-
+
+
+
+
* A x86 computer with VirtualBox installed and enough RAM capacity to be able to run a small virtual machine.
-* The latest stable **YunoHost ISO image**, available [here](https://build.yunohost.org).
+* The latest stable **YunoHost ISO image**, available [here](/images).
---
@@ -48,7 +48,7 @@ Start the virtual machine
* Un ordinateur x86 avec VirtualBox installé et assez de RAM disponible pour lancer une petite machine virtuelle.
-* La dernière **image ISO YunoHost** stable, disponible [ici](https://build.yunohost.org).
+* La dernière **image ISO YunoHost** stable, disponible [ici](/images_fr).
---
@@ -47,7 +47,7 @@ Démarrez votre machine virtuelle
+ 
-resolv-retry infinite
-ns-cert-type server
-topology subnet
-Et on créer un premier instantané
+Et on crée un premier instantané
À présent on peut commencer à travailler sur la machine virtuelle et créer autant d'instantanés que souhaité pour jalonner le travail.
diff --git a/port_forwarding.md b/port_forwarding.md
new file mode 100644
index 00000000..c24f5542
--- /dev/null
+++ b/port_forwarding.md
@@ -0,0 +1,6 @@
+# Port forwarding
+
+The sketch below tries to briefly summarize the role and necessity of port
+forwarding when setting up a server at home.
+
+
diff --git a/port_forwarding_fr.md b/port_forwarding_fr.md
new file mode 100644
index 00000000..1793b27b
--- /dev/null
+++ b/port_forwarding_fr.md
@@ -0,0 +1,6 @@
+# Redirection de ports
+
+Le schéma ci-dessous tente d'expliquer brièvement le rôle de la redirection des
+ports lors de la mise en place d'un serveur à la maison.
+
+
diff --git a/postinstall.md b/postinstall.md
index ca60982b..35246f63 100644
--- a/postinstall.md
+++ b/postinstall.md
@@ -4,7 +4,7 @@ The step called "**post-installation**" is actually the initial configuration of
## Access
-You can access it graphically by entering your **server's local IP** address in a **web browser** (e.g. `http://192.168.1.7`).
+You can access it graphically by entering your **server's local IP** address in a **web browser** (e.g. `http://192.168.1.7`; you'll get this from the client table on your router's admin page).
@@ -14,7 +14,7 @@ You can access it graphically by entering your **server's local IP** address in
Or by running `yunohost tools postinstall` in command-line.
-
+
Preview of the command-line post-installation
@@ -26,7 +26,7 @@ Or by running `yunohost tools postinstall` in command-line. This is the first domain name linked to your YunoHost server, but also the one which will be used by your server's users to access the **authentication portal**. It will thus be **visible by everyone**, choose it wisely. -* If you do not have a domain name, or if you want to use the YunoHost's DynDNS service, choose a sub-domain of **.nohost.me** or **.noho.st** (i.e. `homersimpson.nohost.me`). The domain will be configured automatically and you won't need any further configuration step. +* If you do not have a domain name, or if you want to use the YunoHost's DynDNS service, choose a sub-domain of **.nohost.me** or **.noho.st** (e.g. `homersimpson.nohost.me`). The domain will be configured automatically and you won't need any further configuration step. * If you do know what **DNS** is, you probably want to configure your own domain name here. In this case, please refer to the [DNS page](/dns) page for more informations. @@ -40,16 +40,22 @@ This password will be used to access to your server's [administration interface] --- -## Troubleshooting +## Congratz! -### Secured connection fails after **post-installation** +If you got so far and saw 'YunoHost has been successfully installed' (web +postinstall) or 'YunoHost has been correctly configured', then congratulations! -If you're using your own domain and depending on your browser, you might be stuck out of your Yunohost installation until you deploy an appropriate certificate. Thanks to Yunohost and [Let's Encrypt](https://letsencrypt.org/), this proves to be quite easy: just run `yunohost domain cert-install` in command-line to issue and install your certificate and _Voilà_. Refresh your browser and you're good to go. +### What now ? ---- +- If you're self-hosting at home and without a VPN, you need to [make sure to + correctly forward ports on your router/Internet box](isp_box_config) ; +- If you're using your own domain name (i.e. not a .nohost.me / .noho.st), you + need to [configure it according to the recommended DNS + configuration](dns_config) ; +- If you cannot configure your domain name yet (because you didn't register it + yet, or because this is a test domain), see last paragraph + [here](dns_local_network) for a workaround ; +- Don't be too afraid of the [certificate warning](certificate), you'll probably + be able to install a Let's Encrypt certificate :). +- Have a look at [the available apps](apps) ! -## And after ? - -Once the post-installation finished, check if you can access to your server with your web-browser. If it is not the case, a few more configuration steps may be required. - -Do not hesitate to come on our [support chatroom](/support) if you need help. diff --git a/postinstall_fr.md b/postinstall_fr.md index b6a5d88f..f2beebcc 100644 --- a/postinstall_fr.md +++ b/postinstall_fr.md @@ -17,7 +17,7 @@ Vous pouvez accéder à la post-installation graphique en entrant dans un naviga Vous pouvez aussi y accéder en entrant la commande `yunohost tools postinstall` directement sur le serveur ou en SSH. -
+
*Aperçu de la post-installation en ligne de commande
* @@ -46,16 +46,24 @@ De manière générale, c’est la **clé d’entrée à votre système**, pense --- -## En cas de problème +## Félicitations ! -### Échec de la connection sécurisée après la **post-installation** +Si vous arrivez ici après avoir vu "YunoHost a été installé avec succès" depuis +votre navigateur ou la ligne de commande, alors félicitations ! -Si vous utilisez votre propre domaine et selon votre navigateur, vous pourriez vous retrouver bloqué à l'entrée de votre Yunohost tant que vous n'avez pas déployé un certificat valide. Grâce à Yunohost et [Let's Encrypt](https://letsencrypt.org/), c'est plutôt simple : exécutez simplement `yunohost domain cert-install` en ligne de commande pour émettre et installer votre certificat et _Voilà_. Rafraichissez votre navigateur et vous êtes paré. +### Et maintenant ? ---- +- Si vous vous auto-hébergez à la maison et sans VPN, il faut vous assurer + de bien [rediriger les ports de votre box internet](isp_box_config_fr) ; +- Si vous utilisez votre propre nom de domaine (i.e. pas un nohost.me / + noho.st), il vous faut [configurer le nom de domaine d'après la configuration + recommandée](dns_config_fr) ; +- Si vous ne pouvez pas configurer le nom de domaine pour le moment (parce qu'il + n'est pas encore acheté, ou parce que c'est un domaine de test), vous pouvez + contourner temporairement le problème avec les instructions du dernier + paragraphe [ici](dns_local_network_fr) ; +- Ne soyez pas trop effrayé par [l'avertissement à propos du + certificat](certificate_fr), vous aurez probablement la possibilité + d'installer un certificat Let's Encrypt :). +- Jetez un oeil aux [applications disponibles](apps_fr) ! -## Et après ? - -Une fois l’étape de post-installation exécutée, vérifiez que votre serveur est accessible en tapant le nom de domaine choisi précédemment dans votre navigateur web. Si celui-ci n’est pas accessible, quelques étapes de configurations supplémentaires sont sûrement nécessaires. - -Rendez-nous visite sur le [salon de support](/support_fr) si vous avez besoin d’aide. diff --git a/regenerate_certificate.md b/regenerate_certificate.md deleted file mode 100644 index 44577685..00000000 --- a/regenerate_certificate.md +++ /dev/null @@ -1,47 +0,0 @@ -# Regenerate certificate - -If you want to generate again -- not renewing -- a certificate for a domain, you can follow those steps: - -(replace **example.org** with your domain) - -```bash -# Save YunoHost's SSL directory location for readability -ssldir=/usr/share/yunohost/yunohost-config/ssl/yunoCA - -# Save the final SSL path (do not forget to change your domain) -finalpath=/etc/yunohost/certs/example.org - -# Save the serial number of the new certificate -serial=$(cat "$ssldir/serial") - -# Backup current certificates for your domain -cp -a $finalpath $finalpath.back - -# Remove certs and configuration file in it -rm $finalpath/{crt.pem,key.pem,openssl.cnf} - -# Copy openSSL's configuration file -cp $ssldir/openssl.cnf $finalpath/ - -# Change yunohost.org with your domain in the configuration -# DO NOT FORGET TO REPLACE example.org ! -sed -i "s/yunohost.org/example.org/g" $finalpath/openssl.cnf - -# Generate certificate and key -openssl req -new -config $finalpath/openssl.cnf -days 3650 -out $ssldir/certs/yunohost_csr.pem -keyout $ssldir/certs/yunohost_key.pem -nodes -batch - -# Sign certificate with your server's CA -openssl ca -config $finalpath/openssl.cnf -days 3650 -in $ssldir/certs/yunohost_csr.pem -out $ssldir/certs/yunohost_crt.pem -batch - -# Copy certificate and key to the right place -cp $ssldir/newcerts/$serial.pem $finalpath/crt.pem -cp $ssldir/certs/yunohost_key.pem $finalpath/key.pem - -# Fix permissions -chmod 755 $finalpath -chmod 640 $finalpath/key.pem $finalpath/crt.pem -chmod 600 $finalpath/openssl.cnf - -# Allow metronome to access those certificates -chown root:metronome $finalpath/key.pem $finalpath/crt.pem -``` \ No newline at end of file diff --git a/regenerate_certificate_fr.md b/regenerate_certificate_fr.md deleted file mode 100644 index 7243dec7..00000000 --- a/regenerate_certificate_fr.md +++ /dev/null @@ -1,47 +0,0 @@ -#Régénérer un certificat - -Si vous désirez générer à nouveau — et non renouveler — un certificat pour un domain, suivre les étapes suivantes : - -(remplacer **example.org** avec votre domaine) - -```bash -# Sauvegarde du répertoire SSL de YunoHost, pour la lisibilité -ssldir=/usr/share/yunohost/yunohost-config/ssl/yunoCA - -# Sauvegarde du chemin final SSL (ne pas oublier de modifier avec votre domaine) -finalpath=/etc/yunohost/certs/example.org - -# Sauvegarde du numéro de série du nouveau certificat -serial=$(cat "$ssldir/serial") - -# Sauvegarde du certificat actuel du domaine -cp -a $finalpath $finalpath.back - -# Suppression des certificats et des fichiers de configuration -rm $finalpath/{crt.pem,key.pem,openssl.cnf} - -# Copie du fichier de configuration d’openSSL -cp $ssldir/openssl.cnf $finalpath/ - -# Changement de la configuration yunohost.org avec votre domaine -# NE PAS OUBLIER DE REMPLACER example.org ! -sed -i "s/yunohost.org/example.org/g" $finalpath/openssl.cnf - -# Generation du certificat et de la clé -openssl req -new -config $finalpath/openssl.cnf -days 3650 -out $ssldir/certs/yunohost_csr.pem -keyout $ssldir/certs/yunohost_key.pem -nodes -batch - -# Signature du certificat avec le CA du serveur -openssl ca -config $finalpath/openssl.cnf -days 3650 -in $ssldir/certs/yunohost_csr.pem -out $ssldir/certs/yunohost_crt.pem -batch - -# Copie du certificat et de la clé au bon endroit -cp $ssldir/newcerts/$serial.pem $finalpath/crt.pem -cp $ssldir/certs/yunohost_key.pem $finalpath/key.pem - -# Réparation des permissions -chmod 755 $finalpath -chmod 640 $finalpath/key.pem $finalpath/crt.pem -chmod 600 $finalpath/openssl.cnf - -# Autoriser metronome à accéder aux certificats -chown root:metronome $finalpath/key.pem $finalpath/crt.pem -``` \ No newline at end of file diff --git a/roadmap.md b/roadmap.md deleted file mode 100644 index ec5f92df..00000000 --- a/roadmap.md +++ /dev/null @@ -1,26 +0,0 @@ -# Roadmap - -2.0 2.2 Roadmap - -## v2.4 -Core: -* ✔ Helpers for app maintainer *(ju, opi, jerome)* -* ✔ Install script refactored *(ju)* -* ✔ Use templates to (re)generate configurations instead of packages *(kload, beudbeud, jerome)* -* ✔ Complete and improve backup and restore system *(jerome, ljf)* -* Logging bug on SSOwat when no HTTP referer is sent -* Add tools in moulinette to manage certificate (add, remove, update), Let’s Encrypt *(ljf, Moul)* -* Run automatic tests on moulinette *(kload)* -* Add proper upgrade/remove scripts and comment Debian scripts in packages *(beudbeud)* -* Replace amavis by rspamd *(jerome)* - -Web interface: -* ✔ Use Gulp for administration and user web interfaces *(opi)* -* User avatar *(opi)* -* Plugin system for the admin panel *(ljf)* - -Applications: -* ✔ New way to [manage apps list](http://github.com/YunoHost/apps) - -Other: -* ✔ Add licenses on YunoHost repositories *(Moul)* \ No newline at end of file diff --git a/security.md b/security.md index f571914f..5ba71f0f 100644 --- a/security.md +++ b/security.md @@ -8,7 +8,7 @@ Two things remain important to note: * The fact that YunoHost is a well-spread software increase chances to face an attack. If a flaw is discovered, it could potentially affect all the YunoHost instances at once. Keep your system **up-to-date** to remain safe. -*If you need some advises, do not hesitate to [ask us](/support).* +*If you need some advices, do not hesitate to [ask us](/help).* *To talk about security flaws, contact the [YunoHost security team](/security_team).* @@ -41,7 +41,9 @@ PasswordAuthentication no ``` Save and restart SSH daemon. - +```bash +systemctl restart ssh +``` --- ### Modify SSH port @@ -52,19 +54,27 @@ To prevent SSH connection attempts by robots that scan the Internet for any atte ```bash nano /etc/ssh/sshd_config - -# Search line "Port" and remplace port number (by default 22) by another not used number +``` +**Search line "Port" and replace** port number (by default 22) by another not used number +```bash +# What ports, IPs and protocols we listen for Port 22 # to replace by 9777 for example ``` -Save and restart SSH daemon. +**Open the port** in firewall (you can use -6 option to limit forbid ipv4 connexion) +```bash +yunohost firewall allow TCP 9777 +``` +Save and restart SSH daemon. Switch over to the new port by restarting SSH. +```bash +systemctl restart ssh +``` Then restart the iptables firewall and close the old port in iptables. ```bash yunohost firewall reload yunohost firewall disallow
#### Others Self-hosting projects
-- [ArkOS](https://arkos.io)
+##### Under active development
- [Cloudron](https://cloudron.io)
- [Cozy](https://cozy.io)
- [FreedomBox](https://wiki.debian.org/FreedomBox)
-- [Host@home](http://yeuxdelibad.net/Programmation/Hostathome.html)
- [Libre.sh](https://github.com/indiehosters/libre.sh)
- [Puffin](http://puffin.rocks)
- [Sandstorm](https://sandstorm.io/)
- [Sovereign](https://github.com/al3x/sovereign)
- [UBOS](http://ubos.net)
+##### Unmaintained
+- [ArkOS](http://web.archive.org/web/20170603213149/https://arkos.io/)
+- [Host@home](http://web.archive.org/web/20160206150730/http://yeuxdelibad.net/Programmation/Hostathome.html)
+
+
#### Learn more
* [Decentralized Web Summit](http://www.decentralizedweb.net/)
* [Feudal Security](https://www.schneier.com/blog/archives/2012/12/feudal_sec.html) Bruce Schneier, famous security expert exposes the risks of a centralized web and the importance of civic action.
diff --git a/selfhosting_fr.md b/selfhosting_fr.md
index bae9ff39..1d3af99b 100644
--- a/selfhosting_fr.md
+++ b/selfhosting_fr.md
@@ -1,4 +1,4 @@
-#L’auto-hébergement
+# L’auto-hébergement
#### Définition
L’**auto-hébergement** consiste à héberger chez soi son serveur, ses données et ses services.
@@ -25,17 +25,21 @@ Si vous vous servez du système de [courrier électronique](/email_fr), et que v
#### Autres projets d’auto-hébergement
-- [ArkOS](https://arkos.io)
+##### En développement
- [Cloudron](https://cloudron.io)
- [Cozy](https://cozy.io)
- [FreedomBox](https://wiki.debian.org/FreedomBox)
-- [Host@home](http://yeuxdelibad.net/Programmation/Hostathome.html)
- [Libre.sh](https://github.com/indiehosters/libre.sh)
- [Puffin](http://puffin.rocks)
- [Sandstorm](https://sandstorm.io/)
- [Sovereign](https://github.com/al3x/sovereign)
- [UBOS](http://ubos.net)
+##### Non maintenu
+- [ArkOS](http://web.archive.org/web/20170603213149/https://arkos.io/)
+- [Host@home](http://web.archive.org/web/20160206150730/http://yeuxdelibad.net/Programmation/Hostathome.html)
+
+
#### Pour aller plus loin
* [Auto-hebergement.fr](http://www.auto-hebergement.fr/)
* [Conférence de Benjamin Bayart - Internet libre, ou Minitel 2.0 ?](http://www.fdn.fr/internet-libre-ou-minitel-2.html)
diff --git a/selfhosting_ru.md b/selfhosting_ru.md
new file mode 100644
index 00000000..07881197
--- /dev/null
+++ b/selfhosting_ru.md
@@ -0,0 +1,43 @@
+#Самостоятельное развертывание (свой хостинг)
+
+#### Значение
+**Свой хостинг** - это сервер, расположенный у вас дома и предназначенный для размещения информации для личных нужд.
+
+#### Обязанности администратора
+Свой хостинг создает для вас определенные обязанности, если вы хотите разместить на нём сайт, [e-mail](email_en), а также запустить [систему мгновенных сообщений](XMPP), ваш сервер должен работать и оставаться онлайн 24/7.
+
+Распространенные проблемы, по причине которых сервер может быть недоступен включают в себя: отсутствие электроэнергии, потеря доступа к Интернету, итд.
+
+К примеру, если вы используете [e-mail](email_en) и ваш сервер по какой-то причине становится недоступен, отправленные на него сообщения будут отправлены снова только по прошествии от 3 до 7 дней.
+
+#### Минусы своего хостинга
+* Медленная передача данных. При использовании ADSL, скорость загрузки составляет 1/10 от скорости закачки. К примеру при скорости загрузки 1Мб/с скорость загрузки будет около 100Кб/с;
+* Сервер должен быть доступен 24/7;
+* Перенос данных;
+
+#### Плюсы своего хостинга
+* Анонимность, приватность;
+* Вы - единственный хозяин ваших данных и сервисов;
+* Возможность децентрализации и использования распределенных сетей;
+
+
+
+#### Другие проекты, предназначенные для самостоятельного развертывания
+##### В активной разработке
+- [Cloudron](https://cloudron.io)
+- [Cozy](https://cozy.io)
+- [FreedomBox](https://wiki.debian.org/FreedomBox)
+- [Libre.sh](https://github.com/indiehosters/libre.sh)
+- [Puffin](http://puffin.rocks)
+- [Sandstorm](https://sandstorm.io/)
+- [Sovereign](https://github.com/al3x/sovereign)
+- [UBOS](http://ubos.net)
+
+##### Неподдерживаемые
+- [ArkOS](http://web.archive.org/web/20170603213149/https://arkos.io/)
+- [Host@home](http://web.archive.org/web/20160206150730/http://yeuxdelibad.net/Programmation/Hostathome.html)
+
+
+#### Узнать больше
+* [Decentralized Web Summit](http://www.decentralizedweb.net/)
+* [Feudal Security](https://www.schneier.com/blog/archives/2012/12/feudal_sec.html) Bruce Schneier, famous security expert exposes the risks of a centralized web and the importance of civic action.
diff --git a/shell_variables_scope.md b/shell_variables_scope.md
new file mode 100644
index 00000000..aba9d163
--- /dev/null
+++ b/shell_variables_scope.md
@@ -0,0 +1,219 @@
+### General scope of variables
+
+Variables exists for the current shell and its children only.
+Another script executed from the script is not a child, it's another shell which herited only the environment variables from its caller script, not its globals or locals variables.
+
+When a script is called, it isn't started in the current shell, but in a new instance of bash which herite environment variables from its parent.
+```bash
+var1=value1
+export var2=value2
+
+echo "$var1"
+echo "$var2"
+# var1 and var2 exist
+
+echo "-"
+
+echo "
+echo \"\$var1\"
+echo \"\$var2\"" > other_script.sh
+chmod +x other_script.sh
+./other_script.sh
+# Here, var1 doesn't exist, only var2 still exists.
+# Because it's an environment variable.
+```
+In your current shell, where you launch this script, try
+```bash
+echo $var1 - $var2
+```
+None of this 2 variables exists, because their scope is limited to the script itself. Never its parent.
+
+
+### Functions inside a script
+
+Use a function would not change the scope of variables.
+```bash
+var1=value1
+export var2=value2
+
+set_variable () {
+ var3=value3
+ export var4=value4
+
+ echo "$var1"
+ echo "$var2"
+ echo "$var3"
+ echo "$var4"
+ # All variables exists here
+ # Because the function inherite its variables from the script.
+}
+
+set_variable
+
+echo "$var1"
+echo "$var2"
+echo "$var3"
+echo "$var4"
+# var1 var2, var3 and var4 exist
+# var3 exist because the function is executed in the same shell than the script itself.
+
+echo "-"
+
+echo "
+echo \"\$var1\"
+echo \"\$var2\"
+echo \"\$var3\"
+echo \"\$var4\"" > other_script.sh
+chmod +x other_script.sh
+./other_script.sh
+# Here, var1 and var3 don't exist, only var2 and var4 still exist.
+# Because they're environment variables.
+```
+
+### The usage of locales variables
+
+Locales variables are limited to the function and its children.
+```bash
+var1=value1
+export var2=value2
+
+set_variable () {
+ var3=value3
+ export var4=value4
+ local var5=value5
+
+ echo "$var1"
+ echo "$var2"
+ echo "$var3"
+ echo "$var4"
+ echo "$var5"
+ # All variables exists here
+ # Because the function inherite its variables from the script.
+}
+
+set_variable
+
+echo "-"
+
+echo "$var1"
+echo "$var2"
+echo "$var3"
+echo "$var4"
+echo "$var5"
+# var1 var2, var3 and var4 exist
+# var3 exist because the function is executed in the same shell than the script itself.
+# var5 doesn't exist, because its scope is limited to the function which declare it.
+
+echo "-"
+
+echo "
+echo \"\$var1\"
+echo \"\$var2\"
+echo \"\$var3\"
+echo \"\$var4\"
+echo \"\$var5\"" > other_script.sh
+chmod +x other_script.sh
+./other_script.sh
+# Here, var1, var3 and var5 don't exist, only var2 and var4 still exist.
+# Because they're environment variables.
+```
+
+Using a local variable is usefull for limit it scope to the function only. And not bother the script in its globality with useless variables.
+But there's also another advantage with local variable, do not modify the content of a global variable.
+```bash
+var1=value1
+var2=value2
+var3=value3
+
+set_variable () {
+ echo "$var1"
+ echo "$var2"
+ echo "$var3"
+
+ echo "-"
+
+ var2=new_value2
+ local var3=new_value3
+
+ echo "$var1"
+ echo "$var2"
+ echo "$var3"
+ # Values of var2 and var3 are modified in the function.
+}
+
+set_variable
+
+echo "-"
+
+echo "$var1"
+echo "$var2"
+echo "$var3"
+# var3 retake is original value,
+# because in the function, var3 was declared as a new locale variable.
+# But var2 was directly modified, so its value still changed.
+# Because, var2 in the function is still a global variable.
+```
+
+As seen previously, modified or created variables in a function can affect the main script because the function is executed in the same shell.
+But, the things are different if the function is executed in a sub shell, the function become a child which only inherite from its parent.
+```bash
+var1=value1
+var2=value2
+var3=value3
+
+fonction2 () {
+ echo "-"
+ echo "var1=$var1"
+ echo "var2=$var2"
+ echo "var3=$var3"
+ echo "var4=$var4"
+ echo "var5=$var5"
+ # Even var3, which is local, is inherited from the parent function.
+}
+
+set_variable () {
+ echo "var1=$var1"
+ echo "var2=$var2"
+ echo "var3=$var3"
+ # Variables are inherited from the parent.
+
+ echo "-"
+
+ var2=new_value2
+ local var3=new_value3
+ var4=new_value4
+ export var5=new_value5
+
+ echo "var1=$var1"
+ echo "var2=$var2"
+ echo "var3=$var3"
+ echo "var4=$var4"
+ echo "var5=$var5"
+ # Values of var2 and var3 are modified in the function.
+
+ (fonction2)
+}
+
+(set_variable)
+# Start the function in a sub shell.
+
+echo "-"
+
+echo "var1=$var1"
+echo "var2=$var2"
+echo "var3=$var3"
+echo "var4=$var4"
+echo "var5=$var5"
+# var2 and var3 retake their original values.
+# Because the function is in a child shell which never affect its parent.
+# Likewise, var4 and var5 don't exist, because they're been declared in child shell.
+# The parent never inherite from its children shell.
+```
+
+### Conclusion
+
+- The scope of a variable is always the current shell and its children, never its parent shell.
+- An environment variable may be exported to a new shell, detached from the first one. If the last one executed the second one. But, it can't affect the parents.
+- A locale variable in a function, executed in the current shell, can't affect the environment outside of the function. End allow also to not affect a global variable with the same name.
+- A function executed in a sub shell will never affect its parent, with global or local variables.
+- A parent can NEVER be affected by variables defined or modified in its children shell.
diff --git a/shell_variables_scope_fr.md b/shell_variables_scope_fr.md
new file mode 100644
index 00000000..179f3252
--- /dev/null
+++ b/shell_variables_scope_fr.md
@@ -0,0 +1,219 @@
+### Portée générales des variables
+
+Les variables existent pour le shell courant et ses enfants uniquement.
+Un script exécuté depuis le script n'est pas un enfant, c'est un autre shell qui n'héritera que des variables d'environnement du script appelant, pas des variables globales ou locales.
+
+Lors de l'appel d'un script, il n'est pas démarré dans le shell courant, mais dans une nouvelle instance de bash qui hérite des variables d'environnements de son parent.
+```bash
+var1=value1
+export var2=value2
+
+echo "$var1"
+echo "$var2"
+# var1 et var2 existent
+
+echo "-"
+
+echo "
+echo \"\$var1\"
+echo \"\$var2\"" > other_script.sh
+chmod +x other_script.sh
+./other_script.sh
+# Ici, var1 n'existe pas, seul var2 existe encore.
+# Car c'est une variable d'environnement.
+```
+Dans le shell courant, d'où le script est appelé, faite
+```bash
+echo $var1 - $var2
+```
+Aucune des 2 variables n'existent, car leur portée se limite au script appelé. Jamais au parent.
+
+
+### Les fonctions dans un script
+
+Utiliser une fonction ne change pas la portée des variables.
+```bash
+var1=value1
+export var2=value2
+
+set_variable () {
+ var3=value3
+ export var4=value4
+
+ echo "$var1"
+ echo "$var2"
+ echo "$var3"
+ echo "$var4"
+ # Toutes les variables existent ici
+ # car la fonction hérite des variables du script.
+}
+
+set_variable
+
+echo "$var1"
+echo "$var2"
+echo "$var3"
+echo "$var4"
+# var1 var2, var3 et var4 existent
+# var3 existe car la fonction est exécutée dans le même shell que le script lui-même.
+
+echo "-"
+
+echo "
+echo \"\$var1\"
+echo \"\$var2\"
+echo \"\$var3\"
+echo \"\$var4\"" > other_script.sh
+chmod +x other_script.sh
+./other_script.sh
+# Ici, var1 et var3 n'existent pas, seul var2 et var4 existe encore.
+# Car ce sont des variables d'environnements.
+```
+
+### L'usage des variables locales
+
+Les variables locales sont limitées à une fonction et ses enfants
+```bash
+var1=value1
+export var2=value2
+
+set_variable () {
+ var3=value3
+ export var4=value4
+ local var5=value5
+
+ echo "$var1"
+ echo "$var2"
+ echo "$var3"
+ echo "$var4"
+ echo "$var5"
+ # Toutes les variables existent ici
+ # car la fonction hérite des variables du script.
+}
+
+set_variable
+
+echo "-"
+
+echo "$var1"
+echo "$var2"
+echo "$var3"
+echo "$var4"
+echo "$var5"
+# var1 var2, var3 et var4 existent
+# var3 existe car la fonction est exécutée dans le même shell que le script lui-même.
+# var5 n'existe pas, car sa portée se limite à la fonction qui l'a déclaré
+
+echo "-"
+
+echo "
+echo \"\$var1\"
+echo \"\$var2\"
+echo \"\$var3\"
+echo \"\$var4\"
+echo \"\$var5\"" > other_script.sh
+chmod +x other_script.sh
+./other_script.sh
+# Ici, var1, var3 et var5 n'existent pas, seul var2 et var4 existe encore.
+# Car ce sont des variables d'environnements.
+```
+
+L'intérêt d'utiliser une variable locale est donc de limiter cette variable à la seule fonction qui l'a déclaré. Et donc ne pas polluer le script dans sa globalité avec des variables inutile pour ce dernier.
+Il existe également un second avantage à l'usage d'une variable locale, c'est de ne pas modifier le contenu d'une variable globale.
+```bash
+var1=value1
+var2=value2
+var3=value3
+
+set_variable () {
+ echo "$var1"
+ echo "$var2"
+ echo "$var3"
+
+ echo "-"
+
+ var2=new_value2
+ local var3=new_value3
+
+ echo "$var1"
+ echo "$var2"
+ echo "$var3"
+ # La valeurs de var2 et var3 sont modifiées dans la fonction
+}
+
+set_variable
+
+echo "-"
+
+echo "$var1"
+echo "$var2"
+echo "$var3"
+# var3 a repris sa valeur initiale,
+# car dans la fonction var3 a été déclaré comme une nouvelle variable locale.
+# Mais var2 a été modifiée directement, donc sa valeur reste modifiée.
+# Car var2 dans la fonction est resté une variable globale.
+```
+
+Comme vu précédemment, les variables modifiée ou créée dans la fonction affecte le script car la fonction est exécutée dans le même shell que celui-ci.
+Cela change si on exécute la fonction dans un sous-shell, la fonction devient un enfant qui hérite de son parent uniquement.
+```bash
+var1=value1
+var2=value2
+var3=value3
+
+fonction2 () {
+ echo "-"
+ echo "var1=$var1"
+ echo "var2=$var2"
+ echo "var3=$var3"
+ echo "var4=$var4"
+ echo "var5=$var5"
+ # Même var3, qui est locale, est héritée par la fonction enfant.
+}
+
+set_variable () {
+ echo "var1=$var1"
+ echo "var2=$var2"
+ echo "var3=$var3"
+ # Les variables sont héritées du parent.
+
+ echo "-"
+
+ var2=new_value2
+ local var3=new_value3
+ var4=new_value4
+ export var5=new_value5
+
+ echo "var1=$var1"
+ echo "var2=$var2"
+ echo "var3=$var3"
+ echo "var4=$var4"
+ echo "var5=$var5"
+ # La valeurs de var2 et var3 sont modifiées dans la fonction
+
+ (fonction2)
+}
+
+(set_variable)
+# Démarre la fonction dans un shell fils.
+
+echo "-"
+
+echo "var1=$var1"
+echo "var2=$var2"
+echo "var3=$var3"
+echo "var4=$var4"
+echo "var5=$var5"
+# var2 et var3 ont repris leur valeurs initiales,
+# Car la fonction est dans un shell enfant qui n'affecte pas son parent.
+# De même, var4 et var5 n'existent pas, car elle sont déclarées dans un shell enfant.
+# Le parent n'hérite pas des shells enfants.
+```
+
+### Conclusion
+
+- La portée d'une variable est toujours le shell courant et ses enfants, jamais son shell parent.
+- Une variable d'environnement peut être exportée sur un nouveau shell, indépendant du premier. À condition que ce dernier exécute le second. Mais ne peut pas affecter les parents.
+- Une variable locale dans une fonction, exécutée dans le shell courant, n'affecte pas son environnement en dehors de la fonction. Et permet également de ne pas affecter le contenu d'une variable globale de même nom.
+- Une fonction exécutée dans un sous-shell n'affecte jamais le parent, que ses variables soient globales ou locales.
+- Le parent n'est JAMAIS affecté par les variables définies ou modifiées par ses shells enfants.
diff --git a/sitemap.md b/sitemap.md
deleted file mode 100644
index 3f55f39c..00000000
--- a/sitemap.md
+++ /dev/null
@@ -1,123 +0,0 @@
-# Sitemap
-
-* [Homepage](/index)
-
-* [What's YunoHost](/whatsyunohost)
-
-* [Documentation](/docs)
-
- * Try YunoHost
- * [With the demo](/try)
-
- * [Administrator guide](/admindoc)
- * [Self-hosting](/selfhosting_en)
- * [Hardware compatible](/hardware)
- * [Installation guide](/install)
- * [On an OLinuXino board](/install_on_olinuxino)
- * [On an ARM board](/install_on_arm_board)
- - [On an Olimex board](/install_on_olinuxino)
- * [On a Raspberry Pi](/install_on_raspberry)
- * [From an ISO](/install_iso)
- * [On Debian](/install_on_debian)
- * [On VirtualBox](/install_on_virtualbox)
- * [On Vagrant](/vagrant)
- * [On a dedicated or a virtual private server](/install_on_vps)
- * Installation steps
- * [Burn or copy iso](/burn_or_copy_iso)
- * [Boot and graphical install](/boot_and_graphical_install)
- * [Copy YunoHost image on SD card](/copy_image)
- * [Manual instalation](/install_manually)
- * [Plug and boot your server](/plug_and_boot)
- * [Post-instalation](/postinstall)
- * Access to YunoHost server: DNS, domain name, `hosts` file
- * [Diagnostic the access to YunoHost server](/diagnostic)
- * [DNS Settings](/dns)
- * [Registrar](registrar)
- * [DNS Configuration](/dns_config)
- * [Use the YunoHost DNS resolver](/dns_resolver_en)
- * [Dynamic IP address: configure DynDNS](dns_dynamicip_en)
- * [Access his server on his local network](/dns_local_network_en)
- - [IPv6](ipv6_fr)
- - [VPN](vpn_advantage)
- * [Internet service provider](/isp)
- * [Generic configuration of the ISP router](/isp_box_config)
- * Applications
- * [Official applications](/apps_en)
- * [Non-official applications](/apps_in_progress_en)
- * [Update applications](app_update_en)
- * Administration
- * Command-line
- * [Connect to your server with SSH](/ssh)
- * [Command line administration](/moulinette)
- * [Web administration](/admin)
- * [Change administration password](/change_admin_password)
- * [Email](email_en)
- * [Configure email client](email_configure_client_en)
- * [Migrate emails](email_migration_en)
- * [Forms to remove blacklisting of your IP address](blacklist_forms_en)
- * [Use DKIM](dkim)
- * Certificates
- - [Certificates manager](certmanager_en)
- * [Add a certificate certified by an authority](/certificate)
- * [Regenerate self-signed certificate](/regenerate_certificate_en)
- * [Security](/security)
- - [Contact security team](security_team)
- * [Troubleshooting guide](/troubleshooting_guide_en)
- * [YunoHost Tor Hidden Servicer](/torhiddenservice)
- * [Unblock an IP address with Fail2ban](/fail2ban_en)
-
- * [User guide](/userdoc)
- * [User interface](user_interface)
- * [Configure email client](email_configure_client_en)
- * [Instant messaging usage](/XMPP)
- * [Official applications](/apps)
- * [Baikal](/app_baikal_en)
- * [Firefox Sync](/app_ffsync_en)
- * [Tiny Tiny RSS](/app_ttrss_en)
- * [Transmission](/app_transmission_en)
- * [Radicale](/app_radicale)
- * [RoundCube](/app_roundcube_en)
- * [Minidlna](app_minidlna_en)
- * [Community applications](/apps_in_progress_en)
- * [LimeSurvey](/app_limesurvey_en)
-
- * [Contributor guide](/contribute)
- * Developement
- * Applications
- * [Package new application](/packaging_apps)
- * [VirtualBox for apps' packaging](packaging_apps_virtualbox_fr)
- * [Manifest](packaging_apps_manifest_en)
- * [Scripts](packaging_apps_scripts_en)
- * [Arguments management](packaging_apps_arguments_management_en)
- * [Nginx configuration](packaging_apps_nginx_conf_en)
- * [Multi-instance](packaging_apps_multiinstance_en)
- * [Helpers](packaging_apps_helpers_en)
- * [Trap usage](packaging_apps_trap_fr)
- * [Applications levels](packaging_apps_levels_fr)
- * [YEP - YunoHost Enhancement Proposals](packaging_apps_guidelines_fr)
- * [Applications in progress](/apps_in_progress_en)
- * [Wishlist of applications](/apps_wishlist_en)
- * [Contributing to the YunoHost core](/dev)
- * [Creation of system packages](/build_system_en)
- * [Creation of Debian packages](/build_packages_en)
- * [Create an ARM board image](/build_arm_image_en)
- * [Create a live USB image](/create_live_usb)
- * Documentation
- * [Write documentation](/write_documentation)
- * [Accounting to edit documentation](/accounting)
- * [Contribution](/contributordoc)
-
-* Project's life:
- * [Changelog v.2.0](/changelog_2_0_en)
- * [Changelog v.2.2](/changelog_2_2_en)
- * [Roadmap](/roadmap)
- * [Frequently asked questions](/faq_en)
- * [Contributors](contribs)
- - [Project organization](project_organization)
- * [Support](/support_en)
- * [Art Works](artworks_en)
- * [Blog](https://forum.yunohost.org/c/announcement)
- - [Forum](https://forum.yunohost.org)
- - [Chat rooms](chat_rooms_en)
- * [Communication](communication_en)
- * [Help](/help)
diff --git a/sitemap_fr.md b/sitemap_fr.md
deleted file mode 100644
index 68116cec..00000000
--- a/sitemap_fr.md
+++ /dev/null
@@ -1,137 +0,0 @@
-# Plan du site
-
-* [Page d’accueil](/index_fr)
-
-* [En savoir plus](/whatsyunohost_fr)
-
-* [Documentation](/docs_fr)
-
- * Essayer YunoHost
- * [Avec la démo](/try_fr)
-
- * [Guide de l’administrateur](/admindoc_fr)
- * [L’auto-hébergement](/selfhosting_fr)
- * [Matériel compatible](/hardware_fr)
- * [Guide d’installation](/install_fr)
- * [Sur une carte OLinuXino](/install_on_olinuxino_fr)
- * [Sur carte ARM](/install_on_arm_board_fr)
- - [Sur carte Olimex](/install_on_olinuxino_fr)
- * [Sur Raspberry Pi](/install_on_raspberry_fr)
- * [À partir de l’ISO](/install_iso_fr)
- * [Sur Debian](/install_on_debian_fr)
- * [Sur VirtualBox](/install_on_virtualbox_fr)
- * [Sur Vagrant](/vagrant_fr)
- * [Sur un serveur dédié](/install_on_vps_fr)
- * Étapes d’installation
- * [Graver ou copier l’ISO](/burn_or_copy_iso_fr)
- * [Démarrage et installation graphique](/boot_and_graphical_install_fr)
- * [Copier l’image YunoHost sur une carte SD](/copy_image_fr)
- * [Installation manuelle](/install_manually_fr)
- * [Brancher et démarrer votre serveur](/plug_and_boot_fr)
- * [Post-installation](/postinstall_fr)
- * Accès au serveur YunoHost : DNS, nom de domaine, fichier `hosts`
- * [Diagnostic d’un bon accès au serveur YunoHost](/diagnostic_fr)
- * [DNS - Système de nom de domaine](/dns_fr)
- * [Configuration du DNS chez son registrar](/dns_config_fr)
- * [Chez OVH](/OVH_fr)
- * [DNS et installation d’une application sur un sous-domaine](/dns_subdomains_fr)
- * [Bureaux d’enregistrements de nom de domaine — Registrar](registrar_fr)
- * [Utiliser le résolveur DNS de YunoHost](/dns_resolver_fr)
- * [Adresse IP dynamique : configuration d’un DynDNS](dns_dynamicip_fr)
- * [Accéder à son serveur dans son réseau local](/dns_local_network_fr)
- * [Nom de domaine en Nohost.me](/dns_nohost_me_fr)
- - [IPv6](ipv6_fr)
- - [VPN](vpn_advantage_fr)
- * [Fournisseurs d’accès à Internet](/isp_fr)
- * [Configuration générique de la box ou du routeur](/isp_box_config_fr)
- * [Free](/isp_free_fr)
- * [SFR](/isp_sfr_fr)
- * [Orange](/isp_orange_fr)
- * Applications
- * [Applications officielles](/apps_fr)
- * [Applications non officielles](/apps_in_progress_en)
- * [Mise à jour des applications](app_update_fr)
- * Administration
- * En ligne de commande
- * [Connexion à son serveur avec SSH](/ssh_fr)
- * [Administration avec la Moulinette](/moulinette_fr)
- * [Administration web](/admin_fr)
- * [Administration via l'API](/admin_api_fr)
- * [Changer le mot de passe d’administration](/change_admin_password_fr)
- * [Courrier électronique](email_fr)
- * [Configuration d’un client email](email_configure_client_fr)
- * [Migration emails](email_migration_fr)
- * [Formulaires pour enlever son adresse IP des listes noires](blacklist_forms_fr)
- * [Mettre en place DKIM](dkim_fr)
- * Certificats
- - [Gestionnaire de certificats](certmanager_en)
- * [Ajouter un certificat d’une autorité](/certificate_fr)
- * [Régénérer le certificat auto-signé](/regenerate_certificate_fr)
- * [Sécurité](/security_fr)
- - [Contacter l’équipe de sécurité](security_team_fr)
- * [Consulter les fichiers de log du système](/check_logfile_fr)
- * [Guide de dépannage](/troubleshooting_guide_fr)
- * [YunoHost service caché Tor](/torhiddenservice_fr)
- * [Débloquer une IP avec Fail2ban](/fail2ban_fr)
-
- * [Guide de l’utilisateur](/userdoc_fr)
- * [Interface utilisateur](user_interface)
- * [Configurer un client email](email_configure_client_fr)
- * [Utiliser la messagerie instantanée XMPP](/XMPP_fr)
- * [Applications officielles](/apps_fr)
- * [Baïkal](/app_baikal_fr)
- * [Firefox Sync](/app_ffsync_fr)
- * [Jappix](/app_jappix_fr)
- * [Nextcloud](app_nextcloud_fr)
- * [Tiny Tiny RSS](/app_ttrss_fr)
- * [Transmission](/app_transmission_fr)
- * [Radicale](/app_radicale_fr)
- * [RoundCube](/app_roundcube_fr)
- * [Minidlna](app_minidlna_fr)
- * [Applications communautaires](/apps_in_progress_fr)
- * [LimeSurvey](/app_limesurvey_fr)
-
- * [Guide du contributeur](/contribute_fr)
- * Développement
- * [Créer un environnement de développement](ynh_dev_fr)
- * [Présentation du fonctionnement de YunoHost](/package_list_fr)
- * Applications :
- * [Packager des applications](/packaging_apps_fr)
- * [VirtualBox pour le packaging](packaging_apps_virtualbox_fr)
- * [Introduction](packaging_apps_start_fr.md)
- * [Manifeste](packaging_apps_manifest_fr)
- * [Scripts](packaging_apps_scripts_fr)
- * [Gestion des arguments](packaging_apps_arguments_management_fr)
- * [Configuration Nginx](packaging_apps_nginx_conf_fr)
- * [Multi-instance](packaging_apps_multiinstance_fr)
- * [Commandes pratiques](packaging_apps_helpers_fr)
- * [Usage de trap](packaging_apps_trap_fr)
- * [Niveaux des applications](packaging_apps_levels_fr)
- * [YEP - YunoHost Enhancement Proposals](packaging_apps_guidelines_fr)
- * [Packages d’applications en cours de développement](/apps_in_progress_fr)
- * [Liste de proposition d’applications](/apps_wishlist_fr)
- * [Contribuer au cœur de YunoHost](/dev_fr)
- * [Création de paquets système](/build_system_fr)
- * [Création de paquets Debian](/build_packages_fr)
- * [Créer une image pour carte ARM](/build_arm_image_en)
- * [Créer une image live USB](/create_live_usb_fr)
- * Documentation
- * [Création d’un compte pour l’édition de la documentation](/accounting_fr)
- * [Écrire de la documentation](/write_documentation_fr)
- * [Contribution](/contributordoc_fr)
-
-* Vie du projet :
- * [Journal des modifications v.2.0](/changelog_2_0_en)
- * [Journal des modifications v.2.2](/changelog_2_2_en)
- * [Feuille de route](/roadmap_en)
- * [Foire aux questions](/faq_fr)
- - [Organisation du projet](project_organization_fr)
- * [Contributeurs](contribs_fr)
- * [Entraide - support](/support_fr)
- * [Blog](https://forum.yunohost.org/c/announcement)
- - [Forum](https://forum.yunohost.org)
- - [Salons de discussions](chat_rooms_fr)
- * [Conférences](/conf_fr)
- * [Communication extérieure](communication_fr)
- * [Travail artistique](artworks_fr)
- * [Aide](/help_fr)
diff --git a/ssh.md b/ssh.md
index 741e9e1c..95dc819f 100644
--- a/ssh.md
+++ b/ssh.md
@@ -24,7 +24,7 @@ Assuming your IP address is `111.222.333.444`, open a terminal and enter :
ssh root@111.222.333.444
```
-A password will be asked. If this is a VPS, your VPS provided should have communicated you the password. On a fresh Raspberry Pi, the password should be `yunohost`. For an OLinuXino, this should be `olinux`.
+A password will be asked. If this is a VPS, your VPS provided should have communicated you the password. If you used a pre-installed image (for x86 computer or ARM board), the password should be `yunohost`.
#### Change the password!
@@ -58,7 +58,25 @@ ssh -p 2244 admin@your.domain.tld
By default, only the admin and root users can log in to YunoHost ssh server.
-YunoHost's users created via the administration interface are managed by the LDAP directory. By default, they can't connect via SSH for security reasons. See [here](https://forum.yunohost.org/t/ssh-disconnects-after-successful-login/256/10) if you absolutely want some users to have SSH access enabled.
+YunoHost's users created via the administration interface are managed by the LDAP directory. By default, they can't connect via SSH for security reasons. If you want some users to have SSH access enabled, use the command:
+
+```bash
+yunohost user ssh allow 
@@ -52,10 +52,11 @@ Vous pouvez aussi utiliser [ce script](https://github.com/octopuce/octopuce-good
```bash
-sudo yunohost app upgrade
+$ yunohost app upgrade
Warning: You must provide an URL to upgrade your custom app app_name
Error: No app to upgrade
-sudo yunohost app upgrade -u https://github.com/user/someapp_ynh app_name
+
+$ yunohost app upgrade -u https://github.com/user/someapp_ynh app_name
```
## Les services
@@ -65,7 +66,7 @@ YunoHost utilise toute une série de logiciels pour fonctionner. La plupart de c
Quand quelque chose ne fonctionne pas, une des premières choses à faire est de vérifier que tous les services utilisés par YunoHost sont lancés.
YunoHost inclus un outil qui permet de visualiser tous les services utilisés par YunoHost :
```bash
-sudo yunohost service status
+yunohost service status
```
Exemple de résultat :
@@ -74,7 +75,7 @@ Exemple de résultat :
Tous les services doivent être activés (enabled) et en fonctionnement (running) sauf Glances (optionnel). Si certains ne le sont pas, essayez de les redémarrer.
Voici une petite description de leurs fonctions respectives :
-- **Amavis** : anti-spam/virus/malwares, utilisé quand lors de l’échange de mails.
+- **Amavis** : anti-spam/virus/malwares, utilisé lors de l’échange de mails.
- **Avahi-daemon** : système qui facilite la découverte d’ordinateurs sur le réseau local en leur attribuant des noms.
- **DNSmasq** : serveur DNS, vous n’êtes pas obligé de l’utiliser (Non installé par défaut)
- **Dovecot** : serveur IMAP, utilisé pour la réception de mails.
@@ -94,16 +95,14 @@ Voici une petite description de leurs fonctions respectives :
Les autres services installés par des applications vont aussi apparaître. Par exemple `seafile-serve` utilisé par l’application Seafile et `uwsgi` qui est utilisé par des applications python comme Searx.
##### démarrer ou arrêter un service identifié avec YunoHost :
```bash
-sudo yunohost service start 
-5 à 10 % de mémoire libre est acceptable, mais il est bien de disposer d’une marge (en particulier pour les mises à jour). Comme la plupart du temps, vous ne pouvez pas augmenter votre quantitité de RAM, vous avez la possibilité d’utiliser une partition de SWAP (mémoire du disque dur attribuée à la RAM).
+5 à 10 % de mémoire libre est acceptable, mais il est bien de disposer d’une marge (en particulier pour les mises à jour). Comme la plupart du temps, vous ne pouvez pas augmenter votre quantité de RAM, vous avez la possibilité d’utiliser une partition de SWAP (mémoire du disque dur attribuée à la RAM).
Gardez à l’esprit que le SWAP est une mémoire 100 000 fois plus lente, vous devriez donc l’utiliser uniquement si vous n’avez pas d’autre choix.
##### créer un fichier de swap :
@@ -162,7 +161,7 @@ Changez 512 avec la quantité de mémoire SWAP que vous voulez.
[Source avec plus d’explication](https://meta.discourse.org/t/create-a-swapfile-for-your-linux-server/13880).
## Espace disque
-Un des autres problèmes communs des serveurs est le manque d’espace d’espace disque.
+Un des autres problèmes communs des serveurs est le manque d’espace disque.
Vous pouvez vérifier que votre disque n’est pas plein avec la commande :
```bash
df -h
@@ -203,7 +202,7 @@ alias YNH_WWW_ALIAS ; # chemin pour accéder aux sources des fichiers aux fichie
# Configuration particulière pour une application selon son langage de programmation et ses options de déploiement.
-# Inclure le logo SSOwat en bas à droit de la fenêtre
+# Inclure le logo SSOwat en bas à droite de la fenêtre
include conf.d/yunohost_panel.conf.inc;
}
```
@@ -227,12 +226,12 @@ Ce fichier devrait être vide avec une configuration correcte de Nginx. Si Nginx
Tous les accès à ce domaine (en prenant en comptes toutes les applications).
##### example.com-error.log
-Toutes les erreurs liées aux applications installées sur ce domaine, il se peut que certaines applications aient tous leurs logs surs dans ce fichier.
+Toutes les erreurs liées aux applications installées sur ce domaine, il se peut que certaines applications aient tous leurs logs soit dans ce fichier.
## SSOwat
[SSowat](https://github.com/Kloadut/SSOwat)
-est le logiciel qui connecte le serveur web nginx au serveur LDAP. Son but est d’authentifier les utilisateurs au portail YunHost pour pouvoir simplement changer entre les applications.
+est le logiciel qui connecte le serveur web nginx au serveur LDAP. Son but est d’authentifier les utilisateurs au portail YunoHost pour pouvoir simplement se déplaçer entre les applications.
### Configuration
Vous pouvez regarder le fichier de configuration SSOwat dans le fichier :
@@ -285,7 +284,7 @@ sudo yunohost app setting appname settingname
```
### Logs
-Il n’y a pas de fichier de log créé lors que vous installez une application. Essayez de conserver les logs. Vous pouvez trouver cependant certains logs peuvent se trouver dans :
+Il n’y a pas de fichier de log créé lorsque vous installez une application. Essayez de conserver les logs. Vous pouvez trouver cependant certains logs peuvent se trouver dans :
```bash
/var/log/yunohost/
```
@@ -366,4 +365,4 @@ Ne jamais installer le serveur web Apache ou un paquet avec Apache comme dépend
##### Note sur https
Parfois, le serveur web intégré avec l’application est capable de servir du https lui-même.
-C’est une bonne chose de l’utiliser quand vous disposez d’une application sans Nginx devant. Dans le cadre de YunoHost, le fait que Nginx serve du https simplifie la configuration. Donc, quand vous passez par proxy_pass, utilisez http et Nginx mettra a disposition en https pour le reste de l’internet.
+C’est une bonne chose de l’utiliser quand vous disposez d’une application sans Nginx devant. Dans le cadre de YunoHost, le fait que Nginx serve du https simplifie la configuration. Donc, quand vous passez par proxy_pass, utilisez http et Nginx le mettra a disposition en https pour le reste de l’internet.
diff --git a/try_ar.md b/try_ar.md
new file mode 100644
index 00000000..4ab216e4
--- /dev/null
+++ b/try_ar.md
@@ -0,0 +1,29 @@
+#إسم المستخدم : demo
كلمة السر : demo
كلمة السر : demo
++***تم توفير الخادم التجريبي بفضل +Gitoyen*** +
+ + diff --git a/user_interface_fr.md b/user_interface_fr.md index e9662533..0bdef82e 100644 --- a/user_interface_fr.md +++ b/user_interface_fr.md @@ -1,8 +1,8 @@ -#Interface utilisateur +# Interface utilisateur ### Problème d’accès -L’accès à la partie utilisateur peut se faire uniquement avec un nom de domaine. Vous ne pouvez pas y accéder en utilisant l’adresse IP locale de votre serveur comme suivi : https://adresse.ip.du.server/yunohost/sso +L’accès à la partie utilisateur peut se faire uniquement avec un nom de domaine. Vous ne pouvez pas y accéder en utilisant l’adresse IP locale de votre serveur comme suit : https://adresse.ip.du.server/yunohost/sso Vous pouvez créer une redirection d’un nom de domaine vers l’adresse IP du serveur en modifiant `/etc/hosts` et en ajoutant cette ligne : @@ -10,8 +10,8 @@ Vous pouvez créer une redirection d’un nom de domaine vers l’adresse IP du adresse.ip.du.server domaine.tld ``` -En remplaçant `adresse.ip.du.server` par exemple par `192.168.1.05` et `domaine.tld` par votre nom de domaine ou par un nom de domaine que vous pouvez choisir si vous n’en avez pas. +En remplaçant `adresse.ip.du.server` par exemple par `192.168.1.5` et `domaine.tld` par votre nom de domaine ou par un nom de domaine que vous pouvez choisir si vous n’en avez pas. ### Logiciel -L’interface utilisateur est basé sur le logiciel suivant : https://github.com/Kloadut/ssowat \ No newline at end of file +L’interface utilisateur est basé sur le logiciel suivant : https://github.com/Kloadut/ssowat diff --git a/userdoc.md b/userdoc.md index 53b92bd8..06e3826b 100644 --- a/userdoc.md +++ b/userdoc.md @@ -4,12 +4,4 @@ * [User interface](user_interface) * [Configure an email client](/email) * [Instant messaging usage](/XMPP) -* [Official applications](/apps) - * [Baikal](/app_baikal_en) - * [Firefox Sync](/app_ffsync_en) - * [Tiny Tiny RSS](/app_ttrss_en) - * [Transmission](/app_transmission_en) - * [Radicale](/app_radicale) - * [RoundCube](/app_roundcube_en) -* [Community applications](/apps_in_progress_en) - * [LimeSurvey](/app_limesurvey_en) +* [Applications](/apps) diff --git a/userdoc_ar.md b/userdoc_ar.md new file mode 100644 index 00000000..4eac43e3 --- /dev/null +++ b/userdoc_ar.md @@ -0,0 +1,7 @@ +-/!\ If you prefer use the beta version : https://build.yunohost.org/yunohost-jessie-testing.box -You need to activate the network for the YunoHost instance. ```bash @@ -47,7 +44,7 @@ vagrant ssh Upgrade the system ```bash -sudo apt-get update && sudo apt-get upgrade +sudo apt update && sudo apt dist-upgrade ``` You can access to your vm with the ip 192.168.33.10 diff --git a/vagrant_fr.md b/vagrant_fr.md index 2878e347..ebb0da31 100644 --- a/vagrant_fr.md +++ b/vagrant_fr.md @@ -20,13 +20,9 @@ cd YunoHost La commande suivante va initialiser le projet avec une image YunoHost de base ```bash -vagrant box add yunohost/jessie-stable https://build.yunohost.org/yunohost-jessie-stable.box --provider virtualbox -vagrant init yunohost/jessie-stable +vagrant box add yunohost/stretch-unstable https://build.yunohost.org/yunohost-stretch-unstable.box --provider virtualbox +vagrant init yunohost/stretch-unstable ``` -
-/!\Si vous préférez utiliser la version beta https://build.yunohost.org/yunohost-jessie-testing.box -- Puis, il faut activer le réseau pour l'instance YunoHost: ```bash sed -i 's/# config\.vm\.network "private_network"/config.vm.network "private_network"/' Vagrantfile @@ -48,7 +44,7 @@ vagrant ssh Mettre à jour le système. ```bash -sudo apt-get update && sudo apt-get upgrade +apt update && apt dist-upgrade ``` Vous pouvez accéder à votre vm via l’ip 192.168.33.10. diff --git a/vpn_advantage_fr.md b/vpn_advantage_fr.md index 009e2560..67545d6e 100644 --- a/vpn_advantage_fr.md +++ b/vpn_advantage_fr.md @@ -9,9 +9,9 @@ L'installation d'un serveur chez soi étant une pratique peu courante, la plupar ## Avantages ### Plug & Play -En configurant un VPN sur votre serveur, vous serez en mesure de le rendre accessible au reste d'Internet sans avoir à modifier la configuration du routeur auxquel vous le branchez. Ce point peut être vraiment pratique si vous partez en vacances, que vous déménagez ou que vous ayez une coupure d'Internet car vous serez en mesure de le brancher facilement chez une personne de confiance sans avoir besoin de configurer le routeur de la personne qui vous aide. +En configurant un VPN sur votre serveur, vous serez en mesure de le rendre accessible au reste d'Internet sans avoir à modifier la configuration du routeur auxquel vous le branchez. Ce point peut être vraiment pratique si vous partez en vacances, que vous déménagez ou si vous avez une coupure d'Internet, car vous serez en mesure de le brancher facilement chez une personne de confiance sans avoir besoin de configurer le routeur de la personne qui vous aide. -De la même façon, vous vous économisez l'ouverture des ports de votre routeur ainsi que le coutournement du hairpinning. +De la même façon, vous vous économisez l'ouverture des ports de votre routeur ainsi que le contournement du hairpinning. ### Pas de micro-coupure DNS Si votre connexion Internet n'a pas d'IP publique fixe, vous serez obligé de mettre en place un nom de domaine dynamique (Dynamique DNS). Cette solution peut être acceptable, mais la mise à jour du DNS ne se fera qu'à intervalle régulier (Toutes les deux minutes si c'est un nom de domaine en `noho.st` ou `nohost.me`). Il y a donc une chance que cela provoque de temps en temps des erreurs d'affichage dans le navigateur, voir même qu'un autre site s'affiche (les risques sont toutefois réduit car la pratique de l'auto-hébergement n'est pas répandue). @@ -43,4 +43,4 @@ Lorsque l'on met en place un VPN sur son serveur, si on ne met pas en place de c Pour pallier à ce point, il y a deux solutions : - transformer son serveur en routeur et connecter les équipements de la maison à ce dernier, ces équipements bénéficieront alors de la confidentialité du VPN également. -- utiliser le serveur YunoHost comme solveur DNS lorsque l'on est chez soi, de façon à rediriger les noms de domaines du serveur l'ip locale plutôt que l'ip publique. Cette opération peut se faire soit sur chaque équipements, soit sur le routeur (si ce dernier le permet). +- utiliser le serveur YunoHost comme résolveur DNS lorsque l'on est chez soi, de façon à rediriger les noms de domaines du serveur l'ip locale plutôt que l'ip publique. Cette opération peut se faire soit sur chaque équipements, soit sur le routeur (si ce dernier le permet). diff --git a/whatsyunohost.md b/whatsyunohost.md index d56a1c9d..c8242f55 100644 --- a/whatsyunohost.md +++ b/whatsyunohost.md @@ -38,7 +38,7 @@ It can thus be considered as a distribution, including the following software: * [Postfix](http://www.postfix.org/): an SMTP e-mail server * [Dovecot](http://www.dovecot.org/): an IMAP and a POP3 e-mail server * [Rspamd](https://rspamd.com/): an e-mail spam filtering -* [Metronome](http://www.lightwitch.org/metronome): an XMPP server +* [Metronome](https://metronome.im/): an XMPP server * [OpenLDAP](http://www.openldap.org/): an LDAP server * [Dnsmasq](http://www.thekelleys.org.uk/dnsmasq/doc.html): a DNS server * [SSOwat](https://github.com/Kloadut/SSOwat): a Single Sign On (SSO) web authentication system @@ -118,4 +118,16 @@ First, the software is too young, not tested at large scale and thus probably no You can host your friends, your family and your company safely and with ease, but you have to **trust your users**, and they have to trust you above all. If you do want to provide YunoHost services for unknown persons anyway, a full VPS per user will be just fine, and we believe is a better way to go. +--- +### Art Works + +Black and white YunoHost png logo done by ToZz (400 × 400 px): + +
+
+
+
+Click to download.
+
+Licence: CC-BY-SA 4.0
diff --git a/whatsyunohost_ar.md b/whatsyunohost_ar.md
new file mode 100644
index 00000000..f32b896b
--- /dev/null
+++ b/whatsyunohost_ar.md
@@ -0,0 +1,139 @@
+#
+
+---
+
+###
+
+---
+
+###
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+---
+
+###+« تبًا، لقد سئِمتُ مِن إعادة إعداد خادم البريد الإلكتروني ... Beudbeud، كيف قُمتَ بإعداد خادومك الجميل حول LDAP ؟ »
+Kload، فيفري 2012
@@ -74,7 +74,7 @@ YunoHost est un projet né en février 2012 à la suite d’à peu près ça :
-Il ne manquait en fait qu’une interface d’administration au serveur de Beudbeud pour en faire quelque chose d’exploitable, alors Kload a décidé de la développer. Finalement, après l’automatisation de quelques configurations et le packaging de quelques applications web, YunoHost version 1 était sorti. +Il ne manquait en fait qu’une interface d’administration au serveur de Beudbeud pour en faire quelque chose d’exploitable, alors Kload a décidé de la développer. Finalement, après l’automatisation de quelques configurations et le packaging de quelques applications web, la première version de YunoHost était sortie. Constatant l’engouement croissant autour de YunoHost et de l’auto-hébergement en général, les développeurs et les nouveaux contributeurs ont alors décidé de prendre le cap d’une version 2, plus accessible, plus extensible, plus puissante, et qui prépare du bon café commerce équitable pour les lutins de Laponie. @@ -118,3 +118,17 @@ Même si YunoHost est multi-domaine et multi-utilisateur, il reste **inappropri Premièrement parce que le logiciel est trop jeune, donc non-testé et non-optimisé pour être mis en production pour des centaines d’utilisateurs en même temps. Et quand bien même, ce n’est pas le chemin que l’on souhaite faire suivre à YunoHost. La virtualisation se démocratise, et c’est une façon bien plus étanche et sécurisée de faire de la mutualisation. Vous pouvez héberger vos amis, votre famille ou votre entreprise sans problème, mais vous devez **avoir confiance** en vos utilisateurs, et ils doivent de la même façon avoir confiance en vous. Si vous souhaitez tout de même fournir des services YunoHost à des inconnus, **un VPS entier par utilisateur** sera la meilleure solution. + +--- + +# Logo + +Logo Yunohost noir et blanc réalisé par ToZz (400 × 400 px) : + +« Merde, j’ai la flemme de me reconfigurer un serveur mail... Beudbeud, comment t’as fait pour configurer ton joli serveur sous LDAP ? »
Kload, février 2012
+
+
+
+Cliquer pour télécharger.
+
+Licence: CC-BY-SA 4.0
diff --git a/write_documentation.md b/write_documentation.md
index 3c2d9a8d..2a748942 100644
--- a/write_documentation.md
+++ b/write_documentation.md
@@ -2,9 +2,11 @@
## Online
-This site allows to edit content directly online. You can edit any page by pressing `ESC` on your keyboard or by clicking the "Edit" button on the bottom-right side of your screen. You will be able to preview your changes by pressing `ESC` again or by clicking the "preview" button.
+This site allows to edit content directly online.
-** Note: ** If you don't have any account you will have to send the modifications manually.
+You can edit any page by pressing `ESC` on your keyboard or by clicking the "Edit" button on the bottom-right side of your screen. You will be able to preview your changes by pressing `ESC` again or by clicking the "preview" button.
+
+Once edited, you are able to submit your change by filling an email address.
## Via GitHub
@@ -12,4 +14,4 @@ The YunoHost documentation is managed through a [git repository](https://github.
## Syntax
-This page use the markdown syntax, please refer to the [documentation](http://daringfireball.net/projects/markdown/syntax) for further information.
\ No newline at end of file
+This page use the markdown syntax, please refer to the [documentation](https://guides.github.com/features/mastering-markdown/) for further information.
diff --git a/write_documentation_fr.md b/write_documentation_fr.md
index 6641c42e..2c280f83 100644
--- a/write_documentation_fr.md
+++ b/write_documentation_fr.md
@@ -1,19 +1,17 @@
# Rédaction de la documentation
-## Sur le site
+## Sur le site
Ce site permet d’éditer le contenu directement en ligne.
-
-Pour éditer une page, appuyez pour la touche `Échap` ou cliquez sur le bouton « Éditer » en bas à droite de la page. Vous pourrez visualiser vos modifications en appuyant de nouveau sur `Échap`, ou en cliquant sur le bouton « Aperçu » en bas à droite de la page.
-Une fois l’édition effectuée, vous pouvez soumettre vos modifications par mail, ou via un [compte](/accounting_fr).
+Pour éditer une page, appuyez sur la touche `Échap` ou cliquez sur le bouton « Éditer » en bas à droite de la page. Vous pourrez visualiser vos modifications en appuyant de nouveau sur `Échap`, ou en cliquant sur le bouton « Aperçu » en bas à droite de la page.
-** Note :** Si vous n’avez pas de compte, vous devrez envoyer vos modifications manuellement.
+Une fois l’édition effectuée, vous pouvez soumettre vos modifications en renseignant un mail.
-## Via GitHub
+## Via GitHub
-La documentation de YunoHost est gérée par un [dépot Git](https://github.com/YunoHost/doc). Vous pouvez envoyer des pull-requests.
+La documentation de YunoHost est gérée par un [dépot Git](https://github.com/YunoHost/doc). Vous pouvez envoyer des pull-requests.
## Syntaxe
-La documentation utilise la syntaxe Markdown. Veuillez vous référer à la [documentation](http://daringfireball.net/projects/markdown/syntax) pour plus d’informations.
+La documentation utilise la syntaxe Markdown. Veuillez vous référer à la [documentation](https://guides.github.com/features/mastering-markdown/) (en) pour plus d’informations.
diff --git a/ynh_dev_fr.md b/ynh_dev_fr.md
deleted file mode 100644
index fe8f99a9..00000000
--- a/ynh_dev_fr.md
+++ /dev/null
@@ -1,91 +0,0 @@
-## Créer un environnement de développement
-
-
-