From 248187f91925fefe5808eaaaa9932281ddf66979 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Fri, 12 Jun 2015 13:30:08 +0200 Subject: [PATCH 001/229] Update email_fr.md --- email_fr.md | 31 +++++++++++++++++++++---------- 1 file changed, 21 insertions(+), 10 deletions(-) diff --git a/email_fr.md b/email_fr.md index 833236d4..19615d85 100644 --- a/email_fr.md +++ b/email_fr.md @@ -1,4 +1,4 @@ -#Messagerie électronique +# Messagerie électronique YunoHost fournit : * [Postfix](http://www.postfix.org/) : un serveur de messagerie électronique SMTP @@ -6,41 +6,52 @@ YunoHost fournit : * [Amavis](http://amavis.org/) : un antispam * [RoundCube](/apps) : un webmail -###Client lourd de messagerie électronique +### Client lourd de messagerie électronique Il est possible d’accéder à ses courriels grâce à un client lourd de messagerie électronique comme Mozilla Thunderbird ou Évolution. L’adresse mail principale et ton mot de passe sont nécessaire. **Attention:** votre login est votre nom d’utilisateur SSO et non votre adresse mail ou la partie avant le @ -#####Réglages : +##### Réglages : `IMAP | 993 | SSL/TLS` `SMTP | 465 | SSL/TLS` -####Mozilla Thunderbird +#### Mozilla Thunderbird L’utilitaire de détection automatique de Thunderbird ne marche pas correctement avec YunoHost. Il faut donc passer en configuration manuelle. N’oubliez pas d’enlever le point devant le nom domaine. * [Gestion des alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases) -####Pour Android +#### Pour Android L’application [K-9 Mail](https://github.com/k9mail) fonctionne. -###Migration -Les emails peuvent être migrés avec [Larch](https://github.com/rgrove/larch/) : -* sur votre client installez Larch : +### Migration +Les emails peuvent être migrés avec : +* [ImapSync](http://imapsync.lamiral.info/) : + * sur votre client [installez ImapSync](http://imapsync.lamiral.info/INSTALL) : +```bash +sudo dnf install imapsync # Sous Fedora +``` + * Procédez au transfert ente deux serveurs YunoHost : +```bash +imapsync --host1 --port1 993 --ssl1 --user1 --password1 \ +--host2 --port2 993 --ssl2 --user2 --password2 +``` +* [Larch](https://github.com/rgrove/larch/) : + * sur votre client installez Larch : ```bash sudo gem install larch ``` -* Procédez au transfert ente deux serveurs YunoHost : + * Procédez au transfert ente deux serveurs YunoHost : ```bash larch -a -f imaps://serveur_d'origine.org -t imaps://serveur_de_destination.org ``` Pour d’autres types de transferts référez-vous à la documentation de Larch. -####Aller plus loin +#### Aller plus loin * [Conférence de Benjamin Sonntag - L’email](http://www.iletaitunefoisinternet.fr/lemail-par-benjamin-sonntag/) From 43ee08ea0e24f6cdcfe7065f7e6ba20ce6c1ea37 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Fri, 12 Jun 2015 13:30:44 +0200 Subject: [PATCH 002/229] Update email.md --- email.md | 23 +++++++++++++++++------ 1 file changed, 17 insertions(+), 6 deletions(-) diff --git a/email.md b/email.md index e42eef00..6363552d 100644 --- a/email.md +++ b/email.md @@ -1,4 +1,4 @@ -#Email +# Email YunoHost provides: * [Postfix](http://www.postfix.org/): a SMTP email server @@ -13,7 +13,7 @@ You will need your email address and your password. **Caution:** your login is your SSO username and not your email address -#####Settings: +##### Settings: `IMAP | 993 | SSL/TLS` @@ -27,16 +27,27 @@ The automatic detection tool of Thunderbird does not work with YunoHost. You wil * [Manage alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases) -####For Android +#### For Android [K-9 Mail](https://en.wikipedia.org/wiki/K-9_Mail) application works. ### Migration -Emails can be migrated with [Larch](https://github.com/rgrove/larch/): -* on your client install Larch: +Emails can be migrated with: +* [ImapSync](http://imapsync.lamiral.info/): + * on your client [install ImapSync](http://imapsync.lamiral.info/INSTALL) : +```bash +sudo dnf install imapsync # Under Fedora +``` + * Proceed to the transfert between two YunoHost servers: +```bash +imapsync --host1 --port1 993 --ssl1 --user1 --password1 \ +--host2 --port2 993 --ssl2 --user2 --password2 +``` +* [Larch](https://github.com/rgrove/larch/): + * on your client install Larch: ```bash sudo gem install larch ``` -* Proceed to the transfert between two YunoHost servers: + * Proceed to the transfert between two YunoHost servers: ```bash larch -a -f imaps://serveur_d'origine.org -t imaps://serveur_de_destination.org ``` From 0f899773bea465a68716f6cf11e718b6f9e68b26 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Fri, 12 Jun 2015 13:31:27 +0200 Subject: [PATCH 003/229] Update email.md --- email.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/email.md b/email.md index 6363552d..b1d70927 100644 --- a/email.md +++ b/email.md @@ -33,7 +33,7 @@ The automatic detection tool of Thunderbird does not work with YunoHost. You wil ### Migration Emails can be migrated with: * [ImapSync](http://imapsync.lamiral.info/): - * on your client [install ImapSync](http://imapsync.lamiral.info/INSTALL) : + * on your client [install ImapSync](http://imapsync.lamiral.info/INSTALL): ```bash sudo dnf install imapsync # Under Fedora ``` From 8f17d40adc411c59f266eabf50b3e017c7dfbd0f Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Fri, 12 Jun 2015 23:13:23 +0200 Subject: [PATCH 004/229] Update install_on_cubieboard.md --- install_on_cubieboard.md | 40 +++++++++++++++------------------------- 1 file changed, 15 insertions(+), 25 deletions(-) diff --git a/install_on_cubieboard.md b/install_on_cubieboard.md index 7c82f5dc..e274e028 100644 --- a/install_on_cubieboard.md +++ b/install_on_cubieboard.md @@ -1,4 +1,4 @@ -# Install YunoHost on CubieBoard +# Install YunoHost on Cubieboard *Find other ways to install YunoHost **[here](/install)**.* @@ -8,42 +8,32 @@ * CubieBoard 1, 2 or CubieTruck. -* A micro-SD card: **8GB** capacity (or more) and **class10** speed rate are highly recommended -* An other computer to read this guide and access to your Cubieboard -* A screen and a keyboard are recommended to control your Cubieboard if a problem occurs +* A micro SD card: **4GB** capacity (or more) and **class10** speed rate are highly recommended * A [reasonable ISP](/isp), preferably with a good and unlimited upstream bandwidth -* The **YunoHost Cubieboard image**, available here (to **unzip**): - * [For Cubieboard 2](http://build.yunohost.org/yunohost-cubieboard-a20-2014-10-14.img.zip) --- -## Installation steps +## Installation +* Download the latest **[image of ARMbian Jessie for Cubieboard](http://www.igorpecovnik.com/2013/12/24/cubietruck-debian-wheezy-sd-card-image/)** -1. Copy image to the SD card +Copy image to the SD card -Before putting SD card on Cubieboard create repository nginx: -```bash -mkdir media/cubieboard/var/log/ngnix -``` +Plug & boot -2. Plug & boot +* Connect via [SSH](ssh): **root@exemple.tld/ip_address** with the password: **1234**. -4. Post-install +Install YunoHost + +Post-install --- -## Recommended after post-installation +#### Recommended after post-installation +* Use [SSH authentication via key](security) -* Connect via [SSH](ssh): **root@expemple.tld** (password: **yunohost**) -* Change root password: `passwd root` or use [SSH authentication via key](security) -* Upgrade system: `apt-get update && apt-get dist-upgrade && cubian-update` - ---- - -### Create a YunoHost image for Cubieboard 1, 2 or 3 -* **[Scripts for Cubian](https://github.com/M5oul/Yunocubian)** -* A Cubieboard Debian 7/8 image compatible with YunoHost: - * [ARMbian](http://www.igorpecovnik.com/2013/12/24/cubietruck-debian-wheezy-sd-card-image/) +#### See also +* [Scripts to install YunoHost on Cubian](https://github.com/M5oul/Yunocubian) +* Images of Cubieboard Debian 7/8 compatible with YunoHost: * [Cubian](http://cubian.org/) * [Cubieez](http://www.cubieforums.com/index.php?topic=442.0) From 82dd2de0f9d86bdb6a329b116c1b45ee93fe8914 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Fri, 12 Jun 2015 23:14:34 +0200 Subject: [PATCH 005/229] Update install_on_cubieboard_fr.md --- install_on_cubieboard_fr.md | 43 +++++++++++++++---------------------- 1 file changed, 17 insertions(+), 26 deletions(-) diff --git a/install_on_cubieboard_fr.md b/install_on_cubieboard_fr.md index e3d5724f..41d8fa44 100644 --- a/install_on_cubieboard_fr.md +++ b/install_on_cubieboard_fr.md @@ -6,42 +6,33 @@ * Une Cubieboard 1, 2 ou une CubieTruck -* Une carte micro-SD de capacité minimale de **8GB** et vitesse **class10** fortement recommandée -* Un autre ordinateur pour parcourir ce guide et accéder à votre Cubieboard -* Un écran et un clavier sont recommandés pour pouvoir contrôler votre Cubieboard si un problème apparaît +* Une carte micro SD de capacité minimale de **4 GB** et de vitesse **class10** * Un [fournisseur d’accès correct](/isp_fr), de préférence avec une bonne vitesse d’upload -* L’**image YunoHost pour Cubieboard**, disponible ici (à **dézipper**) : - * [Pour Cubieboard 2](http://build.yunohost.org/yunohost-cubieboard-a20-2014-10-14.img.zip) -## Étapes d’installation +## Installation -1. Copier l’image sur une carte SD +* Télécharger la dernière **[image d’ARMbian Jessie pour Cubieboard](http://www.igorpecovnik.com/2013/12/24/cubietruck-debian-wheezy-sd-card-image/)**. -Avant de mettre la carte dans la Cubieboard créer le dossier nginx : -```bash -mkdir media/cubieboard/var/log/ngnix -``` +Copier l’image sur une carte SD -2. Brancher & démarrer +Brancher & démarrer -4. Post-installation +* Se connecter en [SSH](ssh_fr) : **root@exemple.tld/adresse_ip** avec le mot de passe : **1234**. + +Installation de YunoHost + +Post-installation --- -## Recommandé après la post-installation +#### Recommandé après la post-installation +* Utilisez l’[authentification SSH par clé](security_fr) -* Se connecter en [SSH](ssh_fr) : **root@exemple.tld** (mot de passe : **yunohost**) -* Changer le mot de passe root : ```passwd root``` ou utilisez l’[authentification SSH par clé](security_fr) -* Mettre à jour le système d’exploitation : ```apt-get update && apt-get dist-upgrade && cubian-update``` - ---- - -### Créer une image YunoHost pour Cubieboard 1, 2 ou 3 -* **[Scripts pour Cubian](https://github.com/M5oul/Yunocubian)** -* Une image Debian 7/8 pour Cubieboard compatible avec YunoHost : - * [ARMbian](http://www.igorpecovnik.com/2013/12/24/cubietruck-debian-wheezy-sd-card-image/) - * [Cubian](http://cubian.org/) - * [Cubieez](http://www.cubieforums.com/index.php?topic=442.0) +#### Annexes +* [Scripts d’installation de YunoHost pour Cubian](https://github.com/M5oul/Yunocubian) +* Images Debian 7/8 pour Cubieboard compatible avec YunoHost : + * [Cubian](http://cubian.org/) + * [Cubieez](http://www.cubieforums.com/index.php?topic=442.0) --- From fdbf048129a195fbb535dfe1e74880e32d9970b9 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 13 Jun 2015 22:07:33 +0200 Subject: [PATCH 006/229] Update apps_in_progress.md --- apps_in_progress.md | 1 + 1 file changed, 1 insertion(+) diff --git a/apps_in_progress.md b/apps_in_progress.md index 9990d9fa..6d050dcd 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -21,6 +21,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | --- | --- | --- | --- | --- | | [20euros](https://jatekos101.github.io/20euros/) | Moul |
| https://github.com/M5oul/20euros_ynh | Clone of 2048 game with euros | | [243](https://hgentry.github.io/81/) | Moul |
| https://github.com/M5oul/243_ynh | Clone of 2048 game: goal reach 243 | +| Ajax google apis | zamentur |
| https://github.com/zamentur/ajaxgoogleapis_ynh | A mirror of Google Apis | | [Ampache](http://ampache.org/) | beudbeud |
| https://github.com/abeudin/ampache_ynh | Web based audio/video streaming | | [BTSync](http://www.getsync.com/) | tifred |
| https://github.com/drfred1981/btsync_ynh | File synchronization tool | | [Chtickynotes](https://github.com/chtixof/chtickynotes_ynh) | chtixof |
| https://github.com/chtixof/chtickynotes_ynh | A Post-it page | From 2169e174c896cdddf753501152da77b08fe1d1a5 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 14 Jun 2015 13:52:50 +0200 Subject: [PATCH 007/229] Update changelog_2_2.md --- changelog_2_2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/changelog_2_2.md b/changelog_2_2.md index 197d36dc..aad69cf1 100644 --- a/changelog_2_2.md +++ b/changelog_2_2.md @@ -7,7 +7,7 @@ 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 -* ✔ Add Dnsmasq next to Bind9 *(kload)* +* ✔ 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)* From f41f2b923706d2144fd10d3067c3be9049f59cdc Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 14 Jun 2015 15:54:13 +0200 Subject: [PATCH 008/229] Update apps_wishlist.md --- apps_wishlist.md | 1 + 1 file changed, 1 insertion(+) diff --git a/apps_wishlist.md b/apps_wishlist.md index aa35760b..b7ba0382 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -83,6 +83,7 @@ The following list is a compiled wishlist of applications that would be nice-to- * [Twister](http://twister.net.co/) * [Unvis](https://github.com/phixofor/unvis.it) * [Vaultier](http://www.vaultier.org/) +* [Weblate](http://weblate.org/) * [Webmpc](https://github.com/ushis/webmpc) * [WebODF](http://webodf.org/) * [webSync](http://furier.github.io/websync/) From 40236c1256c1c6600d431cd9dfbc4d2666d35fb7 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 14 Jun 2015 16:14:24 +0200 Subject: [PATCH 009/229] Update apps_in_progress.md --- apps_in_progress.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apps_in_progress.md b/apps_in_progress.md index 6d050dcd..95db25b1 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -99,7 +99,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [TagSpaces](http://www.tagspaces.org/) | scith |
| https://github.com/scith/tagspaces_ynh | Manage files using tags | | Tor Client | Bleuchtang |
| https://github.com/labriqueinternet/torclient_ynh| Tor Client for [the Brick](/install_brick) | | [Tor Relay](https://www.torproject.org/docs/tor-doc-relay.html.en) | matlink |
| https://github.com/matlink/torrelay_ynh | Tor node | -| [uCoin](http://ucoin.io/) | Moul |
| https://github.com/M5oul/ucoin_ynh | uCoin node:
free monetary system | +| [uCoin](http://ucoin.io/) | Moul |
| https://github.com/ucoin-io/ucoin_ynh | uCoin node:
free monetary system | | VPN Client | Jvaubourg |
| https://github.com/labriqueinternet/vpnclient_ynh | VPN Client for [the Brick](/install_brick) | | [Webapp Multi](https://github.com/polytan02/webapp_multi_ynh) | polytan02 |
| https://github.com/polytan02/webapp_multi_ynh | Multi instances & multi domains web app without FTP support | | [Webmin](http://webmin.com) | tifred |
| https://github.com/drfred1981/webmin_ynh | Web-based system configuration tool | From 605c9205d2456d9a507db36ba7254846d0f31613 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 14 Jun 2015 18:30:48 +0200 Subject: [PATCH 010/229] Update dns_fr.md --- dns_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dns_fr.md b/dns_fr.md index f097e98a..a82f7cc4 100644 --- a/dns_fr.md +++ b/dns_fr.md @@ -31,7 +31,7 @@ Plusieurs choix s’offrent à vous. Notez que vous pouvez cumuler ces solutions **C’est la méthode recommandée si vous débutez.** 2. Vous pouvez utiliser le service de DNS de votre **registar** (Gandi, OVH, BookMyName ou autre) pour configurer vos noms de domaine. Voici la [configuration DNS standard](/dns_config_fr). -Vous pouvez également consulter les documentations spécifiques à ces différents registrar : [OVH](/OVH_fr), [Gandi](/Gandi_fr), [BookMyName](/BookMyName_fr). +Vous pouvez également consulter les documentations spécifiques à ces différents [bureaux d’enregistrement](/registar_fr) : [Gandi](http://gandi.net), [OVH](/OVH_fr) ou [BookMyName](http://bookmyname.com). **Attention** : Si vous choisissez ce mode de fonctionnement, vous aurez plus de flexibilité, mais rien ne sera automatique. Par exemple si vous souhaitez utiliser `webmail.mon-serveur.org`, vous devrez l’ajouter manuellement chez votre registar. From 279cb96fbcd7b962c9d224f009384a8ad386d6dd Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 14 Jun 2015 18:31:07 +0200 Subject: [PATCH 011/229] Update dns.md --- dns.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dns.md b/dns.md index 9417dbd3..34376687 100644 --- a/dns.md +++ b/dns.md @@ -26,7 +26,7 @@ You have several choices here. Note that you can mix and match solutions if you **This is the recommended option if you are just starting out with self-hosting.** 2. You can use the DNS service offered by your **registrar** (Gandi, NameCheap, BookMyName or others) to configure your domain name. Here is the [standard DNS configuration](/dns_config). -You can also check out these pages for specific registrar documentation: [OVH](/OVH), [Gandi](/Gandi), [BookMyName](/BookMyName) +You can also check out these pages for specific [registar](/registar_en) documentation: [OVH](https://www.ovh.co.uk/index.xml), [Gandi](http://gandi.net), [NameCheap](http://namecheap.com) or [BookMyName](http://bookmyname.com). **Warning**: If you choose this option, you will have more configuration possibilities, but nothing will be done for you. For example, if you want to use `webmail.my-server.org`, you must add it manually to the DNS records with your registrar. From 62200407a7f29934b30fbefc7740bd886a4a395d Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 14 Jun 2015 18:36:14 +0200 Subject: [PATCH 012/229] Update certificate_fr.md --- certificate_fr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/certificate_fr.md b/certificate_fr.md index 95b2cb48..1ac4ef9b 100644 --- a/certificate_fr.md +++ b/certificate_fr.md @@ -72,12 +72,12 @@ En fonction de l’autorité d’enregistrement, des certificats intermédiaires Les certificats intermédiaires et root doivent être réunis avec le certificat obtenu pour créer une chaîne de certificats unifiés. -En cas d’utilisation d’un certificat racine (StartSSL, Cacert) : +En cas d’utilisation d’un certificat racine (Cacert) : ```bash cat ae_certs/ssl.crt ae_certs/intermediate_ca.pem ae_certs/ca.pem | sudo tee crt.pem``` -En cas d’utilisation du certificat intermédiaire seulement. +En cas d’utilisation du certificat intermédiaire seulement (StartSSL). ```bash cat ae_certs/ssl.crt ae_certs/intermediate_ca.pem | sudo tee crt.pem``` From f724ce27a05010186143caacdc95d2836304437f Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 14 Jun 2015 18:36:31 +0200 Subject: [PATCH 013/229] Update certificate.md --- certificate.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/certificate.md b/certificate.md index b8053fe3..6eb31e30 100644 --- a/certificate.md +++ b/certificate.md @@ -72,12 +72,12 @@ Depends on the CA, intermediate certificates and root have to be downloaded. Intermediate certificates and root must be merged with certificates obtained to create a unified chain certificates. -If you use a root certificate (StartSSL) : +If you use a root certificate (Cacert): ```bash cat ae_certs/ssl.crt ae_certs/intermediate_ca.pem ae_certs/ca.pem | sudo tee crt.pem``` -If you use only an intermediate certificate. +If you use only an intermediate certificate (StartSSL). ```bash cat ae_certs/ssl.crt ae_certs/intermediate_ca.pem | sudo tee crt.pem``` From 7d6bfa44d9c079df66ad330e61e5db61108504db Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 14 Jun 2015 18:38:42 +0200 Subject: [PATCH 014/229] Update apps_wishlist.md --- apps_wishlist.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/apps_wishlist.md b/apps_wishlist.md index b7ba0382..a92645b8 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -47,8 +47,7 @@ The following list is a compiled wishlist of applications that would be nice-to- * [Mailman](https://www.gnu.org/software/mailman/) * [Mailpile](https://www.mailpile.is) * [MPD](http://www.musicpd.org/) -* [MediaCrush](https://mediacru.sh/) -* [MediaGoblin](http://mediagoblin.org/) +* [MediaCrush](https://imgrush.com/) * [MinigalNano](https://github.com/sebsauvage/MinigalNano) * [Mirakel](http://mirakel.azapps.de/taskwarrior.html) * [Modoboa](http://modoboa.org/) From 926b941c875691b5196af47a999490507f6fdefa Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Tue, 16 Jun 2015 20:30:13 +0200 Subject: [PATCH 015/229] Update install_brick_fr.md --- install_brick_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/install_brick_fr.md b/install_brick_fr.md index aac0bac1..ce6e994d 100644 --- a/install_brick_fr.md +++ b/install_brick_fr.md @@ -11,7 +11,7 @@ Chez Neutrinet, nous avons par exemple besoin de la directive `topology subnet` ## Télécharger l’image Sur http://repo.labriqueinter.net/ -(prendre la latest http://repo.labriqueinter.net/labriqueinternet_latest.img.tar.gz) +(prendre la latest http://repo.labriqueinter.net/labriqueinternet_latest_wheezy.img.tar.gz) Faire un `dd` de l'image sur la carte SD a destination : From c34c822e9acb14910c297a07a8c56dc9b9be8ba9 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Tue, 16 Jun 2015 20:30:27 +0200 Subject: [PATCH 016/229] Update install_brick.md --- install_brick.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/install_brick.md b/install_brick.md index 902b9101..cdd673eb 100644 --- a/install_brick.md +++ b/install_brick.md @@ -10,7 +10,7 @@ For example, Neutrinet needs the `topology subnet` directive (for Windows compat ## Download ISO Go to http://repo.labriqueinter.net/ -(get latest http://repo.labriqueinter.net/labriqueinternet_latest.img.tar.gz) +(get latest http://repo.labriqueinter.net/labriqueinternet_latest_wheezy.img.tar.gz) Save ISO to to SD card using `dd`: From 70083e912bbf3bd1b7cf090c88353c7e4c585d75 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 18 Jun 2015 12:01:25 +0200 Subject: [PATCH 017/229] Update install_on_digitalocean.md --- install_on_digitalocean.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/install_on_digitalocean.md b/install_on_digitalocean.md index db87df99..0a016d94 100644 --- a/install_on_digitalocean.md +++ b/install_on_digitalocean.md @@ -6,8 +6,8 @@ -* A DigitalOcean account -* A **Debian 7.0 x64** droplet with at least **512MB** RAM +* A [DigitalOcean](https://www.digitalocean.com/) account +* A **Debian 7.x or 8.x 64bits** droplet with at least **512MB** RAM
Note : The `root` user **must** have a password properly set. Run `sudo passwd root` to ensure this. From 02698a00a660f1fccd1762fbebb84a9839d16ab0 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 18 Jun 2015 12:02:23 +0200 Subject: [PATCH 018/229] Update install_on_digitalocean_fr.md --- install_on_digitalocean_fr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/install_on_digitalocean_fr.md b/install_on_digitalocean_fr.md index 50997ecb..bf5112f0 100644 --- a/install_on_digitalocean_fr.md +++ b/install_on_digitalocean_fr.md @@ -6,8 +6,8 @@ -* Un compte DigitalOcean -* Un conteneur **Debian 7.0 x64** avec au moins **512MB** de RAM +* Un compte [DigitalOcean](https://www.digitalocean.com/) +* Un conteneur **Debian 7.x ou 8.x 64 bits** avec au moins **512MB** de RAM
Attention : l’utilisateur `root` doit posséder un mot de passe. Exécutez `sudo passwd root` pour être sûr qu’il est configuré correctement. From 0a6c310a78a4e38de241ea38b1a2ed2f471da430 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 18 Jun 2015 13:16:37 +0200 Subject: [PATCH 019/229] Add troubleshooting_guide.md --- troubleshooting_guide.md | 343 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 343 insertions(+) create mode 100644 troubleshooting_guide.md diff --git a/troubleshooting_guide.md b/troubleshooting_guide.md new file mode 100644 index 00000000..eea9032c --- /dev/null +++ b/troubleshooting_guide.md @@ -0,0 +1,343 @@ +# YunoHost troubleshooting guide + +You can consider this as some kind of administrator guide for troubleshooting or what to check when there is something wrong with your YunoHost server. It's not a step by step guide to make your YunoHost work but more of a list of things to check to help diagnose the issue you may have. This can also be useful for debug when packaging a new application or trying to understand YunoHost architecture. + +## General notes +### Don't break YunoHost +Best way to troubleshoot is to not have to troubleshoot because you have tested everything before deploying it on your server. +That means everytime you want to try a new thing (unofficial app, new specific config, package an app…) try it on a development or testing server not on your production one. For this, use whatever way you think appropriate, you can use YunoHost on a [DigitalOcean droplet](install_on_digitalocean_en) for 1 cent/hour, locally with Docker or a VM for example. +Also: https://wiki.debian.org/DontBreakDebian + +### Use non-official apps with caution +While it's tempting to install every [non-official apps](https://yunohost.org/#/apps_in_progress_en) please don't. Even if the app is marked as ready. Before testing an app you should read at least part of the package source code. Install, remove and upgrade script should be present. +Keep in mind that when you install an app, you execute code on your server with administrator privileges, code that a stranger have put on internet. +From my experience some packaging are excellent, some can break some part of your YunoHost with one install and some others are unmaintained. So before install check package issues, the Forum and the YunoHost support channel to see if other have problem with the app. + +### Check the official documentation +Answer to your question may be already in [the documentatioon](https://yunohost.org/#/sitemap_en). + +### Check the command line help +Learn to use the [YunoHost command line](https://yunohost.org/#/moulinette_en) like a pro. + +## Upgrade +Problems oftenly occurs after an upgrade. After a YunoHost upgrade you may want to [update your apps](https://yunohost.org/#/app_update_en). + +**Check if some processes are using old librairies** + +You're probably familiar with: +```bash +sudo apt-get update && sudo apt-get dist-upgrade +``` +Most of the time it's enough. But in some cases it's possible that some process are still using old versions of upgraded files (such as libraries), that can cause bug. In rare cases that can lead to security concern (ex: upgrade OpenSSL because of a security bug, Nginx will continue to use the version it has in memory). The utility Checkrestart will help you to find and restart them. + +```bash +sudo apt-get install debian-goodies +sudo checkrestart +Found 0 processes using old versions of upgraded files +``` +If some process are running with old librairies versions checkrestart will tell you and propose you a way to restart them. In some cases checkrestart can't find a way to restart them. + + + +Easier way is to reboot if you can. + +You can also use [this script](https://github.com/octopuce/octopuce-goodies/blob/master/checkrestart/checkrestart.octopuce) to automaticaly restart some services if needed. More info in French [here](https://www.octopuce.fr/checkrestart-outil-pratique-de-debian-goodies-et-version-octopuce/). + +**Force an upgrade on a community app** + +/!\ Always check if there is a upgrade script and read it if you can /!\ +```bash +sudo yunohost app upgrade +Warning: You must provide an URL to upgrade your custom app someapp +Error: No app to upgrade +sudo yunohost app upgrade -u https://github.com/user/someapp_ynh someapp +``` + +## Services +YunoHost uses a bunch of software to accomplish its purpose. Most of theses software are registered as service in Debian. [More info](https://yunohost.org/#/whatsyunohost_fr). + +### Check services status +When something doesn't work on your YunoHost, one of the first things to do is to check that all services used by YunoHost are running. +YunoHost include a helper to see the status of all services used by YunoHost: +```bash +sudo yunohost service status +``` + +Sample result: + + + +All services should be enabled and running. Except glances (optional) and tahoe-lafs. If some are not, try to restart them. Here is a short description of what they do: + + - **Amavis**: anti-spam/virus/malwares, used when receiving email + - **Avahi-daemon**: system which facilitates service discovery on a local network via DNS + - **DNSmasq**: DNS server, you may or may not use it + - **Dovecot**: IMAP email server, used to receive email + - **Glances**: optional, used by web administration to display server status + - **Metronome**: XMPP instant messaging server, used by Jappix and some external client + - **MySQL**: database, used by some app + - **Nginx**: web server, used by all web app + - **php5-fpm**: PHP service, used by all app written in PHP + - **Postfix**: SMTP email server, used to send email + - **Postgrey**: Greylisting policy server, if you use YunoHost email, you should [read this](http://en.wikipedia.org/wiki/Greylisting) + - **Slapd**: LDAP server, used for authentification (sso and app) + - **SSH**: Secure Shell, speaks for himself + - **YunoHost-api**: yunohost web administration + +Others services installed by applications can also be present. In my example I have seafile-server wich serves Seafile app and uwsgi which is used to serve python app such as Searx. + +**Start or stop a service which is registered with YunoHost:** +```bash +sudo yunohost service start +sudo yunohost service stop +``` +You can also use the generic Debian command: +```bash +sudo service start/stop/restart +``` +After a launch attempt, always check that the service is running. + +**Note**: Debian Jessie now uses systemd instead of upstart, but, for now it's fully compatible with Debian Wheezy way to handle services. [Useful resource on systemd](https://fedoraproject.org/wiki/SysVinit_to_Systemd_Cheatsheet). + +### Logs +If a service doesn't start you have to check the logs to see what's wrong. There is no generic way for service to store their logs, but most of the times they are in: +```bash +/var/log/ +``` +Here are the some useful for YunoHost: +##### auth.log +connection or attempt to connection to your server. That includes every the time you connect with ssh, every the time a cron job connects, and all the failed (hopefully) attempts to connect by potential intruders. + +##### fail2ban.log +when someone tries to connect to your server and fails multiple times, Fail2ban bans the IP address to avoid bruteforce and (D)DOS attacks. Here you can see if some ip have been banned. + +##### mail.err, mail.info, mail.log, mail.warn +these are Postfix (the mail server) logs, check theses if you have issues with email. + +##### metronome/metronome.err, metronome/metronome.log +XMPP chat server logs. + +##### mysql.err, mysql.log, mysql/error.log +MySQL database logs, these should be empty unless you have trouble with MySQL. + +##### php5-fpm.log +Genereic log for PHP apps. + +##### yunohost.log +this is the log created by the YunoHost installation. If you have issue just after installing YunoHost, check this one. + +This list is not exhaustive. Also some app may put their log in `/var/log` too. Slapd logs are unfortunatly in `/var/log/syslog`. + +## Memory +Sometime issues are caused because you don't have enough free memory. To check it use the following command to check it: +```bash +free -m +``` + + +5-10% of free memory is fine but it's good to have margin (especially for upgrade). Since most of the time you can't upgrade your physical RAM, alternative it to use a swap file. Keep in mind that swap is memory but 100.000 times slower so you want to use it only when you have no other choice. + +**Create a swap file:** +If free -m indicate that you have 0 total for swap line, you may want to add a swap file. +```bash +sudo install -o root -g root -m 0600 /dev/null /swapfile +dd if=/dev/zero of=/swapfile bs=1k count=512k +mkswap /swapfile +swapon /swapfile +echo "/swapfile swap swap auto 0 0" | sudo tee -a /etc/fstab +sudo sysctl -w vm.swappiness=10 +echo vm.swappiness = 10 | sudo tee -a /etc/sysctl.conf +``` + +Change 512 with the number of Mb of swap you want, 512Mb should be enough for YunoHost. After that, check with `free -m` that you swap is activated. +[Source with more explanation](https://meta.discourse.org/t/create-a-swapfile-for-your-linux-server/13880). + +## Disk space +One other common issue on a server is lack of disk space. You can verify that your filesystem are not full with the command: +```bash +df -h +``` +This will show you disk usage, if one of Filesystem is approching to 100% use you may have issue and want to take appropriate actions to liberate space or extend your filesystem. + + + +## Nginx +Nginx play a big part in YunoHost since it serve all the web applications. YunoHost have a specific way to handle its configuration since there are multiple domain and multiple applications. + +### Configuration +**General configuration structure** +```bash +# Main nginx configuration, you don't want to touch this file +/etc/nginx/nginx.conf +# Directory where all yunohost, domain and app config are located +/etc/nginx/conf.d/ +# Configuration of web administration +/etc/nginx/conf.d/yunohost_admin.conf +# Per domain configuration (one per domain) +/etc/nginx/conf.d/example.com.conf +``` + +**Application configuration** + +For each application on a given domain there is a nginx conf file located in: +```bash +/etc/nginx/conf.d/example.com.d/appname.conf +``` +Application configuration file usually follow this type of pattern +```bash +location YNH_WWW_PATH { # path to access the app in browser + alias YNH_WWW_ALIAS ; # Path to source, usually /var/www/appname + +# Specific configuration for the application according to its programming language and deployment option +... +... +# Include SSOWAT user panel in bottom right +include conf.d/yunohost_panel.conf.inc; +} +``` + +### Logs +Nginx logs files are located in this directory: +```bash +/var/log/nginx/ +``` +#### Generic logs: +##### access.log +generic access logs, you will find here all the access to the YunoHost administration and sometimes intrusion tentative. + +##### error.log +should be empty with a correct Nginx config. If Nginx doesn't start, error are probably located in this log. + +#### For each domain name: +##### example.com-access.log +all access to the domain, including all apps. + +##### example.com-error.log +all error regarding app installed on the domain. + +Sometime application may have their logs located here too. + +## SSOwat +SSowat is the software that connect the web server nginx to the LDAP server. His purpose is to authentificate users to the YunoHost portal and all web apps. [More info](https://github.com/Kloadut/SSOwat). + +### Configuration +You can view (don't edit it, it will be often overwritten) your current SSOwat config in the file: +```bash +/etc/ssowat/conf.json +``` +Which is generated by: +```bash +sudo yunohost app ssowatconf +``` +Protip: if you want to add a personalized rule for SSOwat, do it in this file: +```bash +/etc/ssowat/conf.json.persistent +``` +### Logs +There is no specific log for SSOwat, logs are located in nginx logs files. If you see some line with "lua' in it, it's probably ssowat. + +## YunoHost +### Configuration +YunoHost configuration is located in: +```bash +/etc/yunohost/ +``` +If you want to keep a custom service configuration use this file: +```bash +/etc/yunohost/yunohost.conf +``` +For all the service you pass "yes", yunohost will not upgrade the config of the specified service. Do this only if you know what you're doing. + +All apps configurations are located in: +```bash +/etc/yunohost/apps/appname/ +``` +For each app you will find in this directory: + +* **manifest.json**: manifest of the app +* **scripts/**: directory containing all Shell scripts to manage apps + * install + * upgrade + * remove + * backup + * restore +* **config/**: config directory +* **settings.yml**: config of the app, also accessible via sudo YunoHost app setting appname settingname +* **LICENSE**: license of the package + +### Logs +As far as I know there is no logfile for application installation so when you install an app, keep the log. There is some log about the command line utilisation in: +```bash +/var/log/yunohost/ +``` + +## Applications +This part is more for packager or to understand the link between Nginx and webapps. For packaging a new app you should [read this first](https://yunohost.org/#/packaging_apps_en). + +When troubleshooting an application issue can occur at several levels. There is a wide variety of applications and their deployement to YunoHost will differ depending the programation langage of the app. We will deal here with the most common case. +Applications configurations are not treated because it completely differs according to the application. + +**Oversimplified schema** +your browser -> nginx <- (web server) <- runtime (php, python, node.js,...) <- app + +App is interpretated by the runtime, runtime provide or not a webserver, if not a webserver can be added, webserver or runtime communicate with nginx, nginx serve webpage to your browser. + +The purpose of this configuration is to have multiple application on one server but with only the https port (443) open to the world. + +### PHP app +##### Deployment option +PHP works natively with Nginx. + +##### Communication with Nginx +The php interpreter communicate with nginx throught [PHP-FPM](http://php-fpm.org/) which is a [FastCGI](http://en.wikipedia.org/wiki/FastCGI) implementation. + +##### Logs +```bash +/var/log/php5-fpm.log +``` +**YunoHost package example**: [Owncloud](https://github.com/Kloadut/owncloud_ynh). + +### Python app +##### Deployment option +A Python webapp should run with it's own Python interpreter with it's own dependancies, for this, the tool virtualenv is used. +Usually, a light web server will be used to serve the app behind Nginx. [Uwsgi](https://uwsgi-docs.readthedocs.org/en/latest/) is a good example. + +##### Communication with Nginx +Nginx can talk too python server via three ways: + - [proxy_pass](http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass) + - Websocket + - Native uwsgi: uwsgi_pass [Example](https://github.com/abeudin/searx_ynh/blob/master/conf/nginx.conf#L9-L10) + +##### Logs +Specific to the app and/or the webserver used, for example uwsgi: +```bash +/var/log/uwsgi/ +``` +##### Ressources +[good resource in french on Python virtualenv](http://sametmax.com/les-environnement-virtuels-python-virtualenv-et-virtualenvwrapper/) + +**YunoHost package example**: [Searx](https://github.com/abeudin/searx_ynh) + +### Node.js app +##### Deployment option +A Node.js app have it's own web server integrated in node runtime, usually Node will expose the app to a TCP port. + +##### Communication with nginx +The http endpoint will be passed locally to Nginx via proxy_pass. + +##### Logs +This will be app specific. + +##### Ressources + +##### YunoHost app example +[Etherpad-Lite (non-official but good package)](https://github.com/abeudin/etherpadlite_ynh). + +**note**: node runtime can use "a lot" of memory comparated to other app, make sure you have enough. + +### Other (go binary, Java...) +Webapp can take multiple form an can be deployed in many different manner. Go app have usually an integrated webserver, Java can be deployed with Tomcat or equivalent… There is no way I can be exhaustive here, but most of the time your deployement option will expose an http endpoint that you can pass to nginx via proxy_pass. + +**Note on Apache**: never install Apache or a package that have Apache as dependancy, this will probably break YunoHost. + +**Note on https**: sometimes the webserver integrated with the app is capable to serve https on its own, it's ok to use this when you have one application on one server and you don't want to install nginx for example. But in YunoHost case, it's nginx who serve https and this should be only nginx (mostly to simplify configuration). So when passing the local url to nginx via proxy_pass, use http, nginx will https the thing to the open world later. \ No newline at end of file From 3af46a70585643a2cbe05493dc81af9db7509fe0 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 18 Jun 2015 13:31:29 +0200 Subject: [PATCH 020/229] Update sitemap.md --- sitemap.md | 1 + 1 file changed, 1 insertion(+) diff --git a/sitemap.md b/sitemap.md index 1b952b1d..e4fe361d 100644 --- a/sitemap.md +++ b/sitemap.md @@ -44,6 +44,7 @@ * [Main configuration box](/isp_box_config) * [Web administration](/admin) * [Security](/security) + * [Troubleshooting guide](/troubleshooting_guide_en) * [Connect to your server with SSH](/ssh) * [Command line administration](/moulinette) * [Change administration password](/change_admin_password) From dec446e764165e7e131b2611de8534f5f739a557 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 18 Jun 2015 13:31:44 +0200 Subject: [PATCH 021/229] Update sitemap_fr.md --- sitemap_fr.md | 1 + 1 file changed, 1 insertion(+) diff --git a/sitemap_fr.md b/sitemap_fr.md index b324c836..19bf1d23 100644 --- a/sitemap_fr.md +++ b/sitemap_fr.md @@ -48,6 +48,7 @@ * [Free](/isp_free_fr) * [Administration web](/admin_fr) * [Sécurité](/security_fr) + * [Guide de dépannage](/troubleshooting_guide_en) * [Connexion à son serveur en ligne de commande avec SSH](/ssh_fr) * [Administration en ligne de commande avec la Moulinette](/moulinette_fr) * [Changer le mot de passe d'administration](/change_admin_password_fr) From ca1dda3e81ce145958948c4339e936de358cb5c7 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 18 Jun 2015 14:16:39 +0200 Subject: [PATCH 022/229] Update packaging_apps_fr.md --- packaging_apps_fr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packaging_apps_fr.md b/packaging_apps_fr.md index 9fab1cf7..c69038b9 100644 --- a/packaging_apps_fr.md +++ b/packaging_apps_fr.md @@ -139,7 +139,7 @@ La CLI [moulinette](/moulinette) fournit quelques outils pour rendre le packagin sudo yunohost app checkport ```
-Cette commande vérifie le port et retourne une erreur si le port déjà utilisé. +Cette commande vérifie le port et retourne une erreur si le port est déjà utilisé.

@@ -221,7 +221,7 @@ Remarque : ça fonctionne aussi avec une URL Git : yunohost app install https://github.com/auteur/mon_paquet.git ``` ### Ajoutez votre application à la liste des applications en cours d’avancement -Vous pouvez ajouter votre application à [la liste _Work in progress_](https://yunohost.org/#/apps_en). +Vous pouvez ajouter votre application à [la liste _Work in progress_](https://yunohost.org/#/apps_in_progress_en). ### Demander l’intégration de son application à la liste officielle Si vous le souhaitez vous pouvez proposer l'inclusion de l'application dans les applications officielles. Pour ce faire, il faut utiliser le bouton "New App Request" sur http://app.yunohost.org. \ No newline at end of file From 2e3a834700378cceb95578fc46484e2d15831cf7 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 18 Jun 2015 17:53:41 +0200 Subject: [PATCH 023/229] Update troubleshooting_guide.md --- troubleshooting_guide.md | 190 +++++++++++++++++++-------------------- 1 file changed, 95 insertions(+), 95 deletions(-) diff --git a/troubleshooting_guide.md b/troubleshooting_guide.md index eea9032c..fdd8e57e 100644 --- a/troubleshooting_guide.md +++ b/troubleshooting_guide.md @@ -3,28 +3,29 @@ You can consider this as some kind of administrator guide for troubleshooting or what to check when there is something wrong with your YunoHost server. It's not a step by step guide to make your YunoHost work but more of a list of things to check to help diagnose the issue you may have. This can also be useful for debug when packaging a new application or trying to understand YunoHost architecture. ## General notes -### Don't break YunoHost +### Do not break YunoHost Best way to troubleshoot is to not have to troubleshoot because you have tested everything before deploying it on your server. -That means everytime you want to try a new thing (unofficial app, new specific config, package an app…) try it on a development or testing server not on your production one. For this, use whatever way you think appropriate, you can use YunoHost on a [DigitalOcean droplet](install_on_digitalocean_en) for 1 cent/hour, locally with Docker or a VM for example. +That means everytime you want to try a new thing (non-official app, new specific config, package an app…) try it on a development or testing server not on your production one. For this, use whatever way you think appropriate, you can use YunoHost on a [DigitalOcean droplet](install_on_digitalocean_en) for 1 cent/hour, locally with [Docker](/docker_en) or a VM for example. + Also: https://wiki.debian.org/DontBreakDebian ### Use non-official apps with caution While it's tempting to install every [non-official apps](https://yunohost.org/#/apps_in_progress_en) please don't. Even if the app is marked as ready. Before testing an app you should read at least part of the package source code. Install, remove and upgrade script should be present. -Keep in mind that when you install an app, you execute code on your server with administrator privileges, code that a stranger have put on internet. -From my experience some packaging are excellent, some can break some part of your YunoHost with one install and some others are unmaintained. So before install check package issues, the Forum and the YunoHost support channel to see if other have problem with the app. +Keep in mind that when you install an app, you execute code on your server with root privileges. +From my experience, some packaging are excellent and others can break some part of your YunoHost instance. Some packages are unmaintained. So before install check package issues, the [Forum](http://forum.yunohost.org/) and the [YunoHost support room](support_en) to see if other have problem with the app. ### Check the official documentation Answer to your question may be already in [the documentatioon](https://yunohost.org/#/sitemap_en). ### Check the command line help -Learn to use the [YunoHost command line](https://yunohost.org/#/moulinette_en) like a pro. +Learn how to use the [YunoHost commands](https://yunohost.org/#/moulinette_en) like a pro. ## Upgrade Problems oftenly occurs after an upgrade. After a YunoHost upgrade you may want to [update your apps](https://yunohost.org/#/app_update_en). **Check if some processes are using old librairies** -You're probably familiar with: +You are probably familiar with: ```bash sudo apt-get update && sudo apt-get dist-upgrade ``` @@ -48,9 +49,9 @@ You can also use [this script](https://github.com/octopuce/octopuce-goodies/blob /!\ Always check if there is a upgrade script and read it if you can /!\ ```bash sudo yunohost app upgrade -Warning: You must provide an URL to upgrade your custom app someapp +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 someapp +sudo yunohost app upgrade -u https://github.com/user/someapp_ynh app_name ``` ## Services @@ -67,52 +68,53 @@ Sample result: -All services should be enabled and running. Except glances (optional) and tahoe-lafs. If some are not, try to restart them. Here is a short description of what they do: +All services should be enabled and running. Except glances (optional). If some are not, try to restart them. Here is a short description of what they do: - - **Amavis**: anti-spam/virus/malwares, used when receiving email - - **Avahi-daemon**: system which facilitates service discovery on a local network via DNS - - **DNSmasq**: DNS server, you may or may not use it - - **Dovecot**: IMAP email server, used to receive email - - **Glances**: optional, used by web administration to display server status - - **Metronome**: XMPP instant messaging server, used by Jappix and some external client - - **MySQL**: database, used by some app - - **Nginx**: web server, used by all web app - - **php5-fpm**: PHP service, used by all app written in PHP - - **Postfix**: SMTP email server, used to send email - - **Postgrey**: Greylisting policy server, if you use YunoHost email, you should [read this](http://en.wikipedia.org/wiki/Greylisting) - - **Slapd**: LDAP server, used for authentification (sso and app) - - **SSH**: Secure Shell, speaks for himself - - **YunoHost-api**: yunohost web administration +- **Amavis**: anti-spam/virus/malwares, used when receiving email +- **Avahi-daemon**: system which facilitates service discovery on a local network via DNS +- **DNSmasq**: DNS server, you are not forced to use it +- **Dovecot**: IMAP email server, used to receive email +- **Glances**: optional, used by web administration to display server status +- **Metronome**: XMPP instant messaging server, used by Jappix and some external client +- **MySQL**: database, used by some app +- **Nginx**: web server, used by all web app +- **php5-fpm**: PHP service, used by all app written in PHP +- **Postfix**: SMTP email server, used to send email +- **Postgrey**: greylisting policy server, if you use YunoHost email, you should [learn more about greylisting](http://en.wikipedia.org/wiki/Greylisting) +- **Slapd**: LDAP server, used for authentification (SSO and apps) +- [**SSH**](/ssh_en): Secure Shell +- [**SSOwat**](https://github.com/Kloadut/SSOwat/): an simple sign-on +- **YunoHost-API**: YunoHost web administration -Others services installed by applications can also be present. In my example I have seafile-server wich serves Seafile app and uwsgi which is used to serve python app such as Searx. +Others services installed by applications can also be present. For instance, `seafile-serve` which serves Seafile app and `uwsgi` which serve Python apps such as Searx. -**Start or stop a service which is registered with YunoHost:** +##### Start or stop a service which is registered with YunoHost: ```bash sudo yunohost service start sudo yunohost service stop ``` You can also use the generic Debian command: ```bash -sudo service start/stop/restart +sudo service start/stop/restart/reload ``` After a launch attempt, always check that the service is running. -**Note**: Debian Jessie now uses systemd instead of upstart, but, for now it's fully compatible with Debian Wheezy way to handle services. [Useful resource on systemd](https://fedoraproject.org/wiki/SysVinit_to_Systemd_Cheatsheet). +**Note**: Debian Jessie now uses `systemd` instead of `upstart`, but, for now it's fully compatible with Debian Wheezy way to handle services. [Useful resource on systemd](https://fedoraproject.org/wiki/SysVinit_to_Systemd_Cheatsheet). ### Logs -If a service doesn't start you have to check the logs to see what's wrong. There is no generic way for service to store their logs, but most of the times they are in: +If a service won't start you have to check the logs to see what's wrong. There is no generic way for services to store their logs, but there are mainly stocked in: ```bash /var/log/ ``` -Here are the some useful for YunoHost: +Here are the some useful logs files for YunoHost: ##### auth.log -connection or attempt to connection to your server. That includes every the time you connect with ssh, every the time a cron job connects, and all the failed (hopefully) attempts to connect by potential intruders. +Contains connections or attempt of connection to your server. It includes every web, ssh, cron job connection. It also stockes all the failed (hopefully) attempts to connect by a potential intruders connections. ##### fail2ban.log -when someone tries to connect to your server and fails multiple times, Fail2ban bans the IP address to avoid bruteforce and (D)DOS attacks. Here you can see if some ip have been banned. +When someone tries to connect to your server and fails multiple times, Fail2ban bans the IP address to avoid bruteforce and (D)DOS attacks. Here you can see if some IP have been banned. ##### mail.err, mail.info, mail.log, mail.warn -these are Postfix (the mail server) logs, check theses if you have issues with email. +These are Postfix (the mail server) logs, check theses if you have issues with email. ##### metronome/metronome.err, metronome/metronome.log XMPP chat server logs. @@ -121,24 +123,24 @@ XMPP chat server logs. MySQL database logs, these should be empty unless you have trouble with MySQL. ##### php5-fpm.log -Genereic log for PHP apps. +Generic logs for PHP apps. ##### yunohost.log -this is the log created by the YunoHost installation. If you have issue just after installing YunoHost, check this one. +This is the log created at the YunoHost install. If you have issue installing YunoHost, check this file. -This list is not exhaustive. Also some app may put their log in `/var/log` too. Slapd logs are unfortunatly in `/var/log/syslog`. +This list is not exhaustive. Furthermore, some app may put their logs in `/var/log` too. Slapd logs are unfortunately in `/var/log/syslog`. -## Memory -Sometime issues are caused because you don't have enough free memory. To check it use the following command to check it: +## RAM +Issues can be caused by a lack of RAM. To check your memory usage, do the following command: ```bash free -m ``` -5-10% of free memory is fine but it's good to have margin (especially for upgrade). Since most of the time you can't upgrade your physical RAM, alternative it to use a swap file. Keep in mind that swap is memory but 100.000 times slower so you want to use it only when you have no other choice. +5-10% of free memory is fine but it's good to have margin (especially for upgrade). Since most of the time you can't upgrade your physical RAM, alternative it to use a swap file. Keep in mind that swap it's a memory 100.000 times slower, so you may to use it only if you got no other choice. -**Create a swap file:** -If free -m indicate that you have 0 total for swap line, you may want to add a swap file. +##### Create a swap file: +If `free -m` indicate that you have 0 total for swap line, you may want to add a swap file. ```bash sudo install -o root -g root -m 0600 /dev/null /swapfile dd if=/dev/zero of=/swapfile bs=1k count=512k @@ -149,15 +151,15 @@ sudo sysctl -w vm.swappiness=10 echo vm.swappiness = 10 | sudo tee -a /etc/sysctl.conf ``` -Change 512 with the number of Mb of swap you want, 512Mb should be enough for YunoHost. After that, check with `free -m` that you swap is activated. +Change 512 with the quantity of swap memory you want, 512Mb should be enough for YunoHost. After that, check with `free -m` that you swap is activated. [Source with more explanation](https://meta.discourse.org/t/create-a-swapfile-for-your-linux-server/13880). ## Disk space -One other common issue on a server is lack of disk space. You can verify that your filesystem are not full with the command: +One other common issue on a server is lack of disk space. You can check your filesystem are not full with the command: ```bash df -h ``` -This will show you disk usage, if one of Filesystem is approching to 100% use you may have issue and want to take appropriate actions to liberate space or extend your filesystem. +This will show you disk usage, if one file-system is near to be full you could encounter issues. You should take appropriate actions to free space or extend your file-system. @@ -165,11 +167,11 @@ This will show you disk usage, if one of Filesystem is approching to 100% use yo Nginx play a big part in YunoHost since it serve all the web applications. YunoHost have a specific way to handle its configuration since there are multiple domain and multiple applications. ### Configuration -**General configuration structure** +##### General configuration structure ```bash # Main nginx configuration, you don't want to touch this file /etc/nginx/nginx.conf -# Directory where all yunohost, domain and app config are located +# Directory where all YunoHost, domain and app config are located /etc/nginx/conf.d/ # Configuration of web administration /etc/nginx/conf.d/yunohost_admin.conf @@ -177,16 +179,15 @@ Nginx play a big part in YunoHost since it serve all the web applications. YunoH /etc/nginx/conf.d/example.com.conf ``` -**Application configuration** - -For each application on a given domain there is a nginx conf file located in: +##### Application configuration +For each application on a given domain there is a Nginx conf file located in: ```bash /etc/nginx/conf.d/example.com.d/appname.conf ``` Application configuration file usually follow this type of pattern ```bash location YNH_WWW_PATH { # path to access the app in browser - alias YNH_WWW_ALIAS ; # Path to source, usually /var/www/appname + alias YNH_WWW_ALIAS ; # Path to source, usually /var/www/app_name # Specific configuration for the application according to its programming language and deployment option ... @@ -197,35 +198,35 @@ include conf.d/yunohost_panel.conf.inc; ``` ### Logs -Nginx logs files are located in this directory: +Nginx logs files are located in the directory: ```bash /var/log/nginx/ ``` -#### Generic logs: +#### Generic logs ##### access.log -generic access logs, you will find here all the access to the YunoHost administration and sometimes intrusion tentative. +Generic access logs, you will find here all the accesses to the YunoHost administration and sometimes intrusion tentative. ##### error.log -should be empty with a correct Nginx config. If Nginx doesn't start, error are probably located in this log. +Should be empty with a correct Nginx config. If Nginx doesn't start, error are probably located in this log. -#### For each domain name: +#### For each domain name ##### example.com-access.log -all access to the domain, including all apps. +All accesses to the domain, including all apps. ##### example.com-error.log -all error regarding app installed on the domain. +All error regarding app installed on the domain. Sometime application may have their logs located here too. ## SSOwat -SSowat is the software that connect the web server nginx to the LDAP server. His purpose is to authentificate users to the YunoHost portal and all web apps. [More info](https://github.com/Kloadut/SSOwat). +[SSowat](https://github.com/Kloadut/SSOwat) is the software that connect the web server nginx to the LDAP server. His purpose is to authentificate users to the YunoHost portal to switch easily between apps. ### Configuration -You can view (don't edit it, it will be often overwritten) your current SSOwat config in the file: +You can view (don't edit it, it is oftently overwritten) your current SSOwat config in the file: ```bash /etc/ssowat/conf.json ``` -Which is generated by: +Which is generated with the command: ```bash sudo yunohost app ssowatconf ``` @@ -234,7 +235,7 @@ Protip: if you want to add a personalized rule for SSOwat, do it in this file: /etc/ssowat/conf.json.persistent ``` ### Logs -There is no specific log for SSOwat, logs are located in nginx logs files. If you see some line with "lua' in it, it's probably ssowat. +There is no specific logs for SSOwat. There are are located in Nginx logs files. If you see some line with `lua` in it, it's probably SSOwat. ## YunoHost ### Configuration @@ -246,50 +247,52 @@ If you want to keep a custom service configuration use this file: ```bash /etc/yunohost/yunohost.conf ``` -For all the service you pass "yes", yunohost will not upgrade the config of the specified service. Do this only if you know what you're doing. +For all the service you pass `yes`, YunoHost will not upgrade the config of the specified service. Do this only if you know what you're doing. All apps configurations are located in: ```bash -/etc/yunohost/apps/appname/ +/etc/yunohost/apps/app_name/ ``` -For each app you will find in this directory: +In each app packages you will find: * **manifest.json**: manifest of the app -* **scripts/**: directory containing all Shell scripts to manage apps +* **scripts/**: directory containing five Shell scripts to manage apps * install * upgrade * remove * backup * restore * **config/**: config directory -* **settings.yml**: config of the app, also accessible via sudo YunoHost app setting appname settingname -* **LICENSE**: license of the package +* **settings.yml**: config of the app, also accessible with: +```bash +sudo yunohost app setting appname settingname +``` ### Logs -As far as I know there is no logfile for application installation so when you install an app, keep the log. There is some log about the command line utilisation in: +There is no logfile for application install so when you install an app, keep the log. There is some log about the command line usage in: ```bash /var/log/yunohost/ ``` ## Applications -This part is more for packager or to understand the link between Nginx and webapps. For packaging a new app you should [read this first](https://yunohost.org/#/packaging_apps_en). +This part is more for packager or to understand the link between Nginx and webapps. First, you should know [how to package a new app](https://yunohost.org/#/packaging_apps_en). -When troubleshooting an application issue can occur at several levels. There is a wide variety of applications and their deployement to YunoHost will differ depending the programation langage of the app. We will deal here with the most common case. +When troubleshooting an application issue can occur at several levels. There is a wide variety of applications and their deployment to YunoHost will depending on the programming language of the app. We will deal here with the most commons cases. Applications configurations are not treated because it completely differs according to the application. -**Oversimplified schema** -your browser -> nginx <- (web server) <- runtime (php, python, node.js,...) <- app +##### Oversimplified schema +Web browser −> Nginx <− (web server) <− runtime (PHP, Python, Node.js,...) <− app -App is interpretated by the runtime, runtime provide or not a webserver, if not a webserver can be added, webserver or runtime communicate with nginx, nginx serve webpage to your browser. +App is interpretated by the runtime, runtime provide or not a webserver, if not a webserver can be added, webserver or runtime communicate with Nginx, Nginx serve webpage to the web browser. -The purpose of this configuration is to have multiple application on one server but with only the https port (443) open to the world. +The purpose of this configuration is to have multiple application on one server with only the https port (443) open to the whole Internet. -### PHP app +### PHP apps ##### Deployment option PHP works natively with Nginx. ##### Communication with Nginx -The php interpreter communicate with nginx throught [PHP-FPM](http://php-fpm.org/) which is a [FastCGI](http://en.wikipedia.org/wiki/FastCGI) implementation. +The PHP interpreter communicate with Nginx through [PHP-FPM](http://php-fpm.org/) which is a [FastCGI](http://en.wikipedia.org/wiki/FastCGI) implementation. ##### Logs ```bash @@ -297,47 +300,44 @@ The php interpreter communicate with nginx throught [PHP-FPM](http://php-fpm.org ``` **YunoHost package example**: [Owncloud](https://github.com/Kloadut/owncloud_ynh). -### Python app +### Python apps ##### Deployment option -A Python webapp should run with it's own Python interpreter with it's own dependancies, for this, the tool virtualenv is used. +A Python webapp should run with it's own Python interpreter with and it's own dependencies, for this, the tool `virtualenv` is used. Usually, a light web server will be used to serve the app behind Nginx. [Uwsgi](https://uwsgi-docs.readthedocs.org/en/latest/) is a good example. ##### Communication with Nginx -Nginx can talk too python server via three ways: - - [proxy_pass](http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass) - - Websocket - - Native uwsgi: uwsgi_pass [Example](https://github.com/abeudin/searx_ynh/blob/master/conf/nginx.conf#L9-L10) +Nginx can talk to Python server via three ways: +- [proxy_pass](http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass) +- Websocket +- Native uwsgi: uwsgi_pass: [for instance](https://github.com/abeudin/searx_ynh/blob/master/conf/nginx.conf#L9-L10) ##### Logs -Specific to the app and/or the webserver used, for example uwsgi: +Specific to the app and/or the webserver used, for instance uwsgi: ```bash /var/log/uwsgi/ ``` ##### Ressources -[good resource in french on Python virtualenv](http://sametmax.com/les-environnement-virtuels-python-virtualenv-et-virtualenvwrapper/) +[Great resource in french on Python virtualenv](http://sametmax.com/les-environnement-virtuels-python-virtualenv-et-virtualenvwrapper/) **YunoHost package example**: [Searx](https://github.com/abeudin/searx_ynh) -### Node.js app +### Node.js apps ##### Deployment option A Node.js app have it's own web server integrated in node runtime, usually Node will expose the app to a TCP port. -##### Communication with nginx +##### Communication with Nginx The http endpoint will be passed locally to Nginx via proxy_pass. ##### Logs -This will be app specific. +This will be specific to the app. -##### Ressources +**YunoHost app example:** [Etherpad-Lite](https://github.com/abeudin/etherpadlite_ynh). -##### YunoHost app example -[Etherpad-Lite (non-official but good package)](https://github.com/abeudin/etherpadlite_ynh). +**Note**: Node process can use **lot** of memory compared to other app processes, make sure you have enough. -**note**: node runtime can use "a lot" of memory comparated to other app, make sure you have enough. +### Other (Go, Java...) +Webapp can take multiple form an can be deployed in many way. Go app have usually an integrated webserver, Java can be deployed with Tomcat or equivalent… There is no way to be exhaustive here, but most of the time your deployment option will expose an http endpoint that you can pass to Nginx via proxy_pass. -### Other (go binary, Java...) -Webapp can take multiple form an can be deployed in many different manner. Go app have usually an integrated webserver, Java can be deployed with Tomcat or equivalent… There is no way I can be exhaustive here, but most of the time your deployement option will expose an http endpoint that you can pass to nginx via proxy_pass. +* **Note on Apache**: never install Apache or a package withe Apache as dependency, this will probably break your YunoHost intance. -**Note on Apache**: never install Apache or a package that have Apache as dependancy, this will probably break YunoHost. - -**Note on https**: sometimes the webserver integrated with the app is capable to serve https on its own, it's ok to use this when you have one application on one server and you don't want to install nginx for example. But in YunoHost case, it's nginx who serve https and this should be only nginx (mostly to simplify configuration). So when passing the local url to nginx via proxy_pass, use http, nginx will https the thing to the open world later. \ No newline at end of file +* **Note on https**: sometimes the webserver integrated with the app is capable to serve https on its own, it's right to use this when you have one application on one server and you don't want to install Nginx for intance. But in YunoHost case, Nginx who serve https and it simplify configuration. So when passing the local URL to Nginx via proxy_pass, use http, nginx will https the thing to the open world later. \ No newline at end of file From 55493c275b394a863c53198899a24888e1831aac Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 18 Jun 2015 18:03:20 +0200 Subject: [PATCH 024/229] Update troubleshooting_guide.md --- troubleshooting_guide.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/troubleshooting_guide.md b/troubleshooting_guide.md index fdd8e57e..1a80a04f 100644 --- a/troubleshooting_guide.md +++ b/troubleshooting_guide.md @@ -130,7 +130,7 @@ This is the log created at the YunoHost install. If you have issue installing Yu This list is not exhaustive. Furthermore, some app may put their logs in `/var/log` too. Slapd logs are unfortunately in `/var/log/syslog`. -## RAM +## RAM usage Issues can be caused by a lack of RAM. To check your memory usage, do the following command: ```bash free -m @@ -338,6 +338,8 @@ This will be specific to the app. ### Other (Go, Java...) Webapp can take multiple form an can be deployed in many way. Go app have usually an integrated webserver, Java can be deployed with Tomcat or equivalent… There is no way to be exhaustive here, but most of the time your deployment option will expose an http endpoint that you can pass to Nginx via proxy_pass. -* **Note on Apache**: never install Apache or a package withe Apache as dependency, this will probably break your YunoHost intance. +##### Note on Apache +Never install Apache or a package withe Apache as dependency, this will probably break your YunoHost intance. -* **Note on https**: sometimes the webserver integrated with the app is capable to serve https on its own, it's right to use this when you have one application on one server and you don't want to install Nginx for intance. But in YunoHost case, Nginx who serve https and it simplify configuration. So when passing the local URL to Nginx via proxy_pass, use http, nginx will https the thing to the open world later. \ No newline at end of file +##### Note on https +Sometimes the webserver integrated with the app is capable to serve https on its own, it's right to use this when you have one application on one server and you don't want to install Nginx for intance. But in YunoHost case, Nginx who serve https and it simplify configuration. So when passing the local URL to Nginx via proxy_pass, use http, nginx will https the thing to the open world later. \ No newline at end of file From 9343f54a743ad2e7e4367c378f1c50fb52d6b70a Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 18 Jun 2015 19:12:22 +0200 Subject: [PATCH 025/229] Update packaging_apps_fr.md --- packaging_apps_fr.md | 65 +++++++++++++++++++++++++------------------- 1 file changed, 37 insertions(+), 28 deletions(-) diff --git a/packaging_apps_fr.md b/packaging_apps_fr.md index c69038b9..cafe83f4 100644 --- a/packaging_apps_fr.md +++ b/packaging_apps_fr.md @@ -1,19 +1,27 @@ # Packaging d’applications -Il y a quelques petites choses à connaître si vous voulez packager une application pour Yunohost. +Ce document a pour but de vous apprendre à packager une application pour YunoHost. + +### Prérequis +Pour packager une application, voici les prérequis : +* Un compte sur un serveur git comme [GitHub](https://github.com/) pour pouvoir ensuite publier l’application ; +* Maitriser un minimum `git`, le Shell et d’autres notions de programmation ; +* Une [machine virtuelle ou sur un serveur distant](/install_fr) pour packager et tester son paquet. ### Contenu -Un paquet YunoHost est composé de : +Un paquet YunoHost est composé : -* un fichier JSON `manifest.json` -* un répertoire `scripts`, qui contient les scripts `install`, `remove` et `upgrade` -* d'autres répertoires optionnels, comme `sources` ou `conf` si nécessaire +* d’un `manifest.json` +* d’un dossier `scripts`, composé de cinq scripts Shell `install`, `remove`, `upgrade`, `backup` et `restore` +* de dossiers optionnels, contenant les `sources` ou la `conf` +* de la `LICENSE` de votre paquet +* d’une page de présentation de votre paquet contenu dans un `README.md` -Un exemple d'application est disponible ici : https://github.com/opi/example_ynh, n'hésitez pas à vous en servir comme base de travail. +**[Paquet de base](https://github.com/opi/example_ynh)** : n'hésitez pas à vous en servir comme base de travail. ### Manifeste -Le fichier `manifest.json` définit les constantes de l'application, un ensemble de valeurs dont YunoHost a besoin pour identifier l'application et l'installer correctement. Ça ressemble à ça : +Le fichier `manifest.json` définit les constantes de l'application, un ensemble de valeurs dont YunoHost a besoin pour identifier l'application et l'installer correctement. Voici un exemple : ```json { "name": "Roundcube", @@ -23,7 +31,7 @@ Le fichier `manifest.json` définit les constantes de l'application, un ensemble "fr": "Webmail Open Source" }, "license": "GPL-3", - "developer": { + "maintainer": { "name": "kload", "email": "kload@kload.fr", "url": "http://kload.fr" @@ -51,23 +59,23 @@ Le fichier `manifest.json` définit les constantes de l'application, un ensemble } ``` -* **name** : le nom de l'application. Il n'a pas besoin d'être unique, mais c'est conseillé puisque c'est le nom qui apparaît dans la liste des applications pour tous les administrateurs de serveurs YunoHost. +* **name** : le nom de l'application. Son unicité n'est pas nécessaire. Il est tout de même conseillé étant donné que c'est le nom qui apparaît dans la liste des applications pour les administrateurs de serveurs YunoHost. -* **id** : l’identifiant unique de l'application. Vous devez vous assurer qu'il est unique avant de soumettre une demande d'intégration de l'application. +* **id** : l’identifiant unique de l'application. Vous devez vous assurer de son unicité. -* **description** : la description complète de l'application. Vous pouvez la détailler comme bon vous semble. Seulement `en` (English) est requis, mais vous pouvez la traduire en `fr` :) +* **description** : la description complète de l'application. Vous pouvez la détailler comme bon vous semble. Uniquement le champs `en` (English) est requis, mais vous pouvez tout de même ajouter la traduction en français :) -* **license** : la licence avec laquelle l'application est distribuée. Veuillez utiliser le nom abrégé de la licence, par exemple `GPL-3` pour la GNU General Public License version 3. Vous pouvez trouver une liste des abréviations standards ici : https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/#license-field +* **license** : la licence avec laquelle l'application est distribuée. Il ne s’agit pas de la license du paquet qui doit être mise dans le fichier `LICENSE`. Veuillez utiliser le nom abrégé de la licence, par exemple `GPL-3` pour la GNU General Public License version 3. Voici une [liste des abréviations standards](https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/#license-field). -* **developer** : quelques informations à propos du mainteneur du paquet de l'application. +* **maintainer** : quelques informations à propos du mainteneur du paquet de l'application. -* **multi_instance** : définit la possibilité de votre application à être installée plusieurs fois. Quand YunoHost essaie d'installer une seconde fois votre application, il remplaçera `id` dans votre script par un `id__2`. Cela signifie que si voulez être `multi_instance`, vous devez mettre toutes les valeurs identifiantes dans les scripts. -

**Par exemple** : dans mon script roundcube, je dois nommer ma base de donnée `roundcube`, mon répertoire d'installation `roundcube` et ma configuration Nginx `roundcube`. De cette manière, la seconde installation de roundcube ne rentrera pas en conflit, et sera installée dans la base de donnée `roundcube__2`, dans le répertoire `roundcube__2`, et avec la configuration Nginx `roundcube__2`. +* **multi_instance** : définit la possibilité de votre package à être installée plusieurs fois. Quand YunoHost essaie d'installer une seconde fois votre application, il remplaçera l’`id` dans votre script par `id__2`. Cela signifie que si voulez être `multi_instance`, vous devez mettre toutes les valeurs identifiantes dans les scripts. +

**Par exemple** : dans le script roundcube, il faut nommer la base de donnée `roundcube`, le dossier d'installation `roundcube` et la configuration Nginx `roundcube`. De cette manière, la seconde installation de roundcube ne rentrera pas en conflit avec la première, et sera installée dans la base de donnée `roundcube__2`, dans le répertoire `roundcube__2`, et avec la configuration Nginx `roundcube__2`. * **arguments** : les paramètres à demander aux administrateurs du serveur lors de l'installation. `name` est l'identifiant du paramètre, et `ask` la question à poser (au minimum en Anglais -- `en`) que vous pouvez traduire de la même manière que la description ci-dessus. Vous pouvez aussi proposer une valeur par défaut (`default`) et un exemple (`example`) pour aider l'administrateur à remplir le formulaire d’installation. ## Les scripts -Pour le moment, un paquet YunoHost doit contenir trois scripts bash : `install`, `remove`, et `upgrade`. +Un paquet YunoHost doit contenir cinq scripts Shell : `install`, `remove`, `upgrade`, `backup` et `restore`. Ces scripts seront exécutés en tant qu'`admin` sur les serveurs YunoHost. Voici un exemple de script d'`install`: @@ -120,18 +128,18 @@ sudo service nginx reload sudo yunohost app ssowatconf ``` -### Usage -Vous devez tout mettre dans le script pour que votre application soit entièrement installée. Cela signifie que vous devez installer les dépendances, créer les répertoires requis, initialiser les bases de donnés nécessaires, copier les sources et configurer tout dans l'unique script `install` (et bien sûr faire la procédure inverse dans le script `remove`). +### Utilisation +Vous devez tout mettre dans le script d’`install` pour que votre application soit entièrement installée. Cela signifie que vous devez installer les dépendances, créer les répertoires requis, initialiser les bases de donnés nécessaires, copier les sources et configurer tout dans l'unique script `install` (et bien sûr faire la procédure inverse dans le script `remove`). **Attention** : pour des raisons de sécurité, le script est exécuté en tant qu'**admin** dans YunoHost. Assurez-vous de l'essayer en tant qu'**admin** et de préfixer `sudo` aux commandes requises. ### Architecture et arguments -Comme les instances de YunoHost possèdent une architecture unifiée, vous serez capable de deviner la plupart des réglages nécessaires. Mais si vous avez besoin de réglages spécifiques, comme le nom de domaine ou un chemin web pour configurer l’application, vous devrez les demander aux administrateurs lors de l'installation (voir la section `arguments` dans **manifeste** ci-dessus). +Comme les instances de YunoHost possèdent une architecture unifiée, vous serez capable de deviner la plupart des réglages nécessaires. Mais si vous avez besoin de réglages spécifiques, comme le nom de domaine ou un chemin web pour configurer l’application, vous devrez les demander aux administrateurs lors de l'installation (voir la section `arguments` dans le § **Manifeste** ci-dessus). **Remarque** : les arguments seront passés au script dans l'ordre du manifeste. Par exemple pour **roundcube**, l'argument `domain` sera passé en tant que `$1` dans le script, et `path` en tant que `$2`. ### Commandes pratiques -La CLI [moulinette](/moulinette) fournit quelques outils pour rendre le packaging plus facile : +La CLI [moulinette](/moulinette) fournit quelques outils pour faciliter le packaging :
@@ -164,7 +172,7 @@ Il existe aussi `skipped_regex`, `protected_regex`, `unprotected_uris`, `unprote **Attention** : il est nécessaire de lancer `yunohost app ssowatconf` pour appliquer les effets. Les uris seront alors converties en urls et écrites dans le fichier /etc/ssowat/conf.json.

-Exemple:
+Exemple :
```yunohost app setting myapp unprotected_urls -v "/"```
```yunohost app ssowatconf```
Ces commandes vont désactiver le SSO sur la racine de l'aplication soit domain.tld/myapp, ceci est utile pour une application publique. @@ -176,7 +184,7 @@ Ces commandes vont désactiver le SSO sur la racine de l'aplication soit domain. sudo yunohost app checkurl -a ```
-Cette commande est utile pour les applications Web et vous permet d'être sûr que le chemin n'est pas utilisé par une autre application. Si le chemin est inutilisé, elle le « réserve ». +Cette commande est utile pour les applications web et vous permet d'être sûr que le chemin n'est pas utilisé par une autre application. Si le chemin est inutilisé, elle le « réserve ».

**Remarque** : ne pas préfixer par `http://` ou par `https://` dans le ``.
@@ -206,8 +214,8 @@ sudo yunohost app ssowatconf Cette commande régénère la configuration du SSO. Vous devez l'appeler à la fin des scripts lorsque vous packagez une application Web. -### Essais -Afin d'essayer votre packaging d'application, vous pouvez exécuter votre script en tant qu'`admin` (n'oubliez pas d'ajouter les arguments requis) : +### Tests +Afin de tester votre paquet, vous pouvez exécuter votre script en tant qu'`admin` (n'oubliez pas d'ajouter les arguments requis) : ```bash su - admin -c "/bin/bash /répertoire/de/mon/script my_arg1 my_arg2" ``` @@ -220,8 +228,9 @@ Remarque : ça fonctionne aussi avec une URL Git : ```bash yunohost app install https://github.com/auteur/mon_paquet.git ``` -### Ajoutez votre application à la liste des applications en cours d’avancement -Vous pouvez ajouter votre application à [la liste _Work in progress_](https://yunohost.org/#/apps_in_progress_en). +### Publiez et demandez des tests de votre application +* Demandez des tests et des retours sur votre application en publiant un [post sur le Forum](https://forum.yunohost.org/) avec la catégorie `App integration`. -### Demander l’intégration de son application à la liste officielle -Si vous le souhaitez vous pouvez proposer l'inclusion de l'application dans les applications officielles. Pour ce faire, il faut utiliser le bouton "New App Request" sur http://app.yunohost.org. \ No newline at end of file +* [Ajoutez](/write_documentation_fr) votre application à [la liste des apps non officielles](https://yunohost.org/#/apps_in_progress_en). + +* Demander l’[intégration officielle](http://app.yunohost.org) de son paquet. \ No newline at end of file From 73511f673c4bd57c25668b7e41d2444e5af238ce Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 18 Jun 2015 19:59:22 +0200 Subject: [PATCH 026/229] Update packaging_apps_fr.md --- packaging_apps_fr.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/packaging_apps_fr.md b/packaging_apps_fr.md index cafe83f4..f2bd5803 100644 --- a/packaging_apps_fr.md +++ b/packaging_apps_fr.md @@ -5,7 +5,7 @@ Ce document a pour but de vous apprendre à packager une application pour YunoHo ### Prérequis Pour packager une application, voici les prérequis : * Un compte sur un serveur git comme [GitHub](https://github.com/) pour pouvoir ensuite publier l’application ; -* Maitriser un minimum `git`, le Shell et d’autres notions de programmation ; +* Maîtriser un minimum `git`, le Shell et d’autres notions de programmation ; * Une [machine virtuelle ou sur un serveur distant](/install_fr) pour packager et tester son paquet. ### Contenu @@ -13,13 +13,12 @@ Un paquet YunoHost est composé : * d’un `manifest.json` * d’un dossier `scripts`, composé de cinq scripts Shell `install`, `remove`, `upgrade`, `backup` et `restore` -* de dossiers optionnels, contenant les `sources` ou la `conf` -* de la `LICENSE` de votre paquet -* d’une page de présentation de votre paquet contenu dans un `README.md` +* de dossiers optionnels, contenant les `sources` ou de la `conf` +* d’un fichier `LICENSE` contenant la licence du paquet +* d’une page de présentation du paquet contenu dans un fichier `README.md` **[Paquet de base](https://github.com/opi/example_ynh)** : n'hésitez pas à vous en servir comme base de travail. - ### Manifeste Le fichier `manifest.json` définit les constantes de l'application, un ensemble de valeurs dont YunoHost a besoin pour identifier l'application et l'installer correctement. Voici un exemple : ```json @@ -65,9 +64,9 @@ Le fichier `manifest.json` définit les constantes de l'application, un ensemble * **description** : la description complète de l'application. Vous pouvez la détailler comme bon vous semble. Uniquement le champs `en` (English) est requis, mais vous pouvez tout de même ajouter la traduction en français :) -* **license** : la licence avec laquelle l'application est distribuée. Il ne s’agit pas de la license du paquet qui doit être mise dans le fichier `LICENSE`. Veuillez utiliser le nom abrégé de la licence, par exemple `GPL-3` pour la GNU General Public License version 3. Voici une [liste des abréviations standards](https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/#license-field). +* **license** : la licence avec laquelle l'application est distribuée. Il ne s’agit pas de la license du paquet qui, elle, doit être mise dans le fichier `LICENSE`. Veuillez utiliser le nom abrégé de la licence, par exemple `GPL-3` pour la GNU General Public License version 3. Voici une [liste des abréviations standards](https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/#license-field). -* **maintainer** : quelques informations à propos du mainteneur du paquet de l'application. +* **maintainer** : informations à propos du mainteneur du paquet de l'application. * **multi_instance** : définit la possibilité de votre package à être installée plusieurs fois. Quand YunoHost essaie d'installer une seconde fois votre application, il remplaçera l’`id` dans votre script par `id__2`. Cela signifie que si voulez être `multi_instance`, vous devez mettre toutes les valeurs identifiantes dans les scripts.

**Par exemple** : dans le script roundcube, il faut nommer la base de donnée `roundcube`, le dossier d'installation `roundcube` et la configuration Nginx `roundcube`. De cette manière, la seconde installation de roundcube ne rentrera pas en conflit avec la première, et sera installée dans la base de donnée `roundcube__2`, dans le répertoire `roundcube__2`, et avec la configuration Nginx `roundcube__2`. @@ -231,6 +230,7 @@ yunohost app install https://github.com/auteur/mon_paquet.git ### Publiez et demandez des tests de votre application * Demandez des tests et des retours sur votre application en publiant un [post sur le Forum](https://forum.yunohost.org/) avec la catégorie `App integration`. -* [Ajoutez](/write_documentation_fr) votre application à [la liste des apps non officielles](https://yunohost.org/#/apps_in_progress_en). +* [Ajoutez](/write_documentation_fr) votre application à [la liste des apps non officielles](https://yunohost.org/#/apps_in_progress_en) avec l’état du paquet : `Ready`, `In progress` ou `Not working`. -* Demander l’[intégration officielle](http://app.yunohost.org) de son paquet. \ No newline at end of file +### Officialisation d’une application +Pour qu’une application deviennent officielle, elle doit être suffisament testé, stable et fonctionner sous les architectures de processeurs 64 bits, 32 bits et ARM. Si ces conditions vous paraissent réuni, demandez l’[intégration officielle](http://app.yunohost.org) de votre application. \ No newline at end of file From 468ab5b3aac616f426c6ea718401ae30745090b1 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 18 Jun 2015 20:00:03 +0200 Subject: [PATCH 027/229] Update packaging_apps.md --- packaging_apps.md | 60 +++++++++++++++++++++++++++-------------------- 1 file changed, 34 insertions(+), 26 deletions(-) diff --git a/packaging_apps.md b/packaging_apps.md index 8eff7ba1..74330c93 100644 --- a/packaging_apps.md +++ b/packaging_apps.md @@ -1,16 +1,23 @@ # App packaging -There are few things you need to know if you want to package an application for YunoHost. +This document aimed to learn you how to package an application for YunoHost. + +### Requirements +To package an application, here are the requirements: +* An account on a git server as [GitHub](https://github.com/) to publish the application; +* Control a minimum `git`, Shell and other programming stuffs; +* A testing [virtual machine or a distant server](/install_en) to package and test the package. ### Content A YunoHost package is composed of: -* A JSON file `manifest.json` -* A `scripts` directory, which contains the `install`, `remove` and `upgrade` scripts -* Optional other directories, like `sources` or `conf` if you need them - -An example package is available here: https://github.com/opi/example_ynh, feel free to use it as a framework. +* A `manifest.json` file +* A `scripts` directory, which contains five Shell scripts: `install`, `remove`, `upgrade`, `backup` and `restore` +* Optional directories, containing `sources` or `conf` files +* A `LICENSE` file containing the license of the package +* A presentation page of your package in a `README.md` file +**[A basic package](https://github.com/opi/example_ynh)**: feel free to use it as a framework. ### Manifest The `manifest.json` file defines the app's constants, a bunch of values that YunoHost needs to identify the app and install it correctly. It looks like this : @@ -23,7 +30,7 @@ The `manifest.json` file defines the app's constants, a bunch of values that Yun "fr": "Webmail Open Source" }, "license": "GPL-3", - "developer": { + "maintainer": { "name": "kload", "email": "kload@kload.fr", "url": "http://kload.fr" @@ -51,24 +58,23 @@ The `manifest.json` file defines the app's constants, a bunch of values that Yun } ``` -* **name**: The name of the app. It does not have to be unique, but it should be, since it is the name shown to all the YunoHost administrators in the app list. +* **name**: the app name. It does not have to be unique, but it should be, since it is the name shown to all the YunoHost administrators in the app list. -* **id**: The unique ID of the app. You have to ensure that this ID is unique before submit an app integration request. +* **id**: the unique ID of the app. You have to ensure that this ID is unique before submit an app integration request. -* **description**: The complete description of the app. You can make it as detailed as you feel it should be. Only `en` is required right now, but you can translate the description by prepending the locale prefix. +* **description**: the complete description of the app. You can make it as detailed as you feel it should be. Only `en` is required right now, but you can translate the description by prepending the locale prefix. -* **license**: The license under which the app is distributed. Please use the short name of the license, e.g. `GPL-3` for the GNU General Public License v3. You can find a list of standard abbreviations here: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/#license-short-name +* **license**: the license under which the app is distributed. Please use the short name of the license, e.g. `GPL-3` for the GNU General Public License v3. Here is a [list of standard abbreviations](https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/#license-short-name). -* **developer**: Some information about the app maintainer (you!). +* **developer**: informations about the app maintainer. -* **multi_instance**: This defines your app's ability to be installed multiple times. When YunoHost tries to install a second instance of your app, it will replace the `id` in your scripts by an `id__2`. It means that, if you want to be `multi_instance`, you have to put all the identifiers in the scripts. -

**E.g.** In my roundcube script, I have to call my database `roundcube`, my install directory `roundcube` and my nginx configuration `roundcube`. This way, the second instance of roundcube will not conflict, and will be installed in the `roundcube__2` database, in the `roundcube__2`directory, and with the `roundcube__2` nginx configuration. +* **multi_instance**: this defines your app's ability to be installed multiple times. When YunoHost tries to install a second instance of the app, it will replace the `id` in the scripts by an `id__2`. It means that, if you want to be `multi_instance`, you have to put all the identifiers in the scripts. +

**E.g.** in the roundcube script, database is called `roundcube`, the install directory `roundcube` and the Nginx configuration `roundcube`. This way, the second instance of roundcube will not conflict with the first one, and will be installed in the `roundcube__2` database, in the `roundcube__2`directory, and with the `roundcube__2` Nginx configuration. -* **arguments**: The settings for the YunoHost's administrator to enter at installation. You have to set a `name` (for argument identification), and a question in `ask` (at least in `en`) that you can translate like the description above. You can also set a `default` value and an `example` to help administrator to fill the input. +* **arguments**: the settings for the YunoHost's administrator to enter at installation. You have to set a `name` (for argument identification), and a question in `ask` (at least in `en`) that you can translate like the description above. You can also set a `default` value and an `example` to help administrator to fill the input. ## Scripts - -For now, a YunoHost package must contain 3 bash scripts: `install`, `remove`, and `upgrade`. +For now, a YunoHost package must contain five Shell scripts: `install`, `remove`, `upgrade`, `backup` and `restore`. These scripts will be executed as `admin` on the YunoHost instances. Here is an example: @@ -122,14 +128,14 @@ sudo yunohost app ssowatconf ``` ### Usage -You have to put everything in the script in order for the app to install without issue. It means that you have to install dependencies, create required repositories, initialize potential databases, copy sources and configure everything in the single `install` script (and of course do the reverse process in the `remove` script). +You have to put everything in the `install` script in order to get the app to install without issue. It means that you have to install dependencies, create required repositories, initialize potential databases, copy sources and configure everything in the single `install` script (and of course do the reverse process in the `remove` script). -**Be careful**: For security reasons, the script is executed as the **admin** user in YunoHost. Be sure to test it as **admin** and prepend `sudo` to commands that require it. +**Be careful**: for security reasons, the script is executed as the **admin** user in YunoHost. Be sure to test it as **admin** and prepend `sudo` to commands that require it. ### Architecture and arguments Since YunoHost has a unified architecture, you will be able to guess most of the settings you need. But if you need variable ones, like the domain or web path, you will have to ask the administrator at installation (see `arguments` section in the manifest above). -**Note**: The arguments will be passed in the order that they appear in the manifest. For example for **roundcube**, the `domain` argument will be referenced as `$1` in the script, and `path` as `$2`. +**Note**: the arguments will be passed in the order that they appear in the manifest. For example for **roundcube**, the `domain` argument will be referenced as `$1` in the script, and `path` as `$2`. ### Hooks YunoHost provides a hook system, which is accessible via the packager's script callbacks in moulinette (CLI). @@ -187,7 +193,7 @@ sudo yunohost app checkurl -a
This helper is useful for web apps and allows you to be sure that the web path is not taken by another app. If not, it "reserves" the path.

-**Note**: Do not prepend `http://` or `https://` to the ``. +**Note**: do not prepend `http://` or `https://` to the ``.

@@ -214,7 +220,7 @@ In order to test your package, you can execute your script standalone as `admin` su - admin -c "/bin/bash /path/to/my/script my_arg1 my_arg2" ``` -Or you can use moulinette: +Or you can use [moulinette](/moulinette_en): ```bash yunohost app install /path/to/my/app/package ``` @@ -222,8 +228,10 @@ Note that it also works with a Git URL: ```bash yunohost app install https://github.com/author/my_app_package.git ``` -### Add your application to the work in progress list of applications -You can add your application to the [_Work in progress_ list](https://yunohost.org/#/apps_en). +### Publish and ask for testing your application +* Publishing a [post on the Forum](https://forum.yunohost.org/) with the `App integration` category, to ask tests and returns on your application. -### Ask integration of your application to the official list -If you want, you can ask integration of your application to officials applications. To do so, use button "New App Request" on http://app.yunohost.org. +* [Add](/write_documentation_en) your application to the [non-officials list of application](https://yunohost.org/#/apps_in_progress_en) with the state of the package: `Ready`, `In progress` or `Not working`. + +### Officalization of an application +To become an official application, it must be enough tested, stable and should works on 64 bits, 32 bits et ARM processors architectures. If you think thoses conditions are gather, ask for [official integration](http://app.yunohost.org) of your application. \ No newline at end of file From f33d9fd166a681b397c7e6014be45a80125646f0 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 18 Jun 2015 20:00:49 +0200 Subject: [PATCH 028/229] Update packaging_apps.md --- packaging_apps.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packaging_apps.md b/packaging_apps.md index 74330c93..db973007 100644 --- a/packaging_apps.md +++ b/packaging_apps.md @@ -66,7 +66,7 @@ The `manifest.json` file defines the app's constants, a bunch of values that Yun * **license**: the license under which the app is distributed. Please use the short name of the license, e.g. `GPL-3` for the GNU General Public License v3. Here is a [list of standard abbreviations](https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/#license-short-name). -* **developer**: informations about the app maintainer. +* **maintainer**: informations about the app maintainer. * **multi_instance**: this defines your app's ability to be installed multiple times. When YunoHost tries to install a second instance of the app, it will replace the `id` in the scripts by an `id__2`. It means that, if you want to be `multi_instance`, you have to put all the identifiers in the scripts.

**E.g.** in the roundcube script, database is called `roundcube`, the install directory `roundcube` and the Nginx configuration `roundcube`. This way, the second instance of roundcube will not conflict with the first one, and will be installed in the `roundcube__2` database, in the `roundcube__2`directory, and with the `roundcube__2` Nginx configuration. From 14a512a01765c5b647fb76f17a63420de43a0911 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Fri, 19 Jun 2015 00:00:19 +0200 Subject: [PATCH 029/229] Update apps_in_progress.md --- apps_in_progress.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/apps_in_progress.md b/apps_in_progress.md index 95db25b1..5af131ab 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -21,7 +21,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | --- | --- | --- | --- | --- | | [20euros](https://jatekos101.github.io/20euros/) | Moul |
| https://github.com/M5oul/20euros_ynh | Clone of 2048 game with euros | | [243](https://hgentry.github.io/81/) | Moul |
| https://github.com/M5oul/243_ynh | Clone of 2048 game: goal reach 243 | -| Ajax google apis | zamentur |
| https://github.com/zamentur/ajaxgoogleapis_ynh | A mirror of Google Apis | +| Ajax google apis | zamentur |
| https://github.com/zamentur/ajaxgoogleapis_ynh | Google APIs mirror | | [Ampache](http://ampache.org/) | beudbeud |
| https://github.com/abeudin/ampache_ynh | Web based audio/video streaming | | [BTSync](http://www.getsync.com/) | tifred |
| https://github.com/drfred1981/btsync_ynh | File synchronization tool | | [Chtickynotes](https://github.com/chtixof/chtickynotes_ynh) | chtixof |
| https://github.com/chtixof/chtickynotes_ynh | A Post-it page | @@ -36,6 +36,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Etherpad-Lite](http://etherpad.org) | beudbeud |
| https://github.com/abeudin/etherpadlite_ynh | Real-time collaborative document editing | | [FileBin](http://sebsauvage.net/wiki/doku.php?id=php:zerobin) | IsserTerrus |
| https://github.com/isserterrus/filebin_ynh | Online filebin | | [Firefox Sync](https://www.mozilla.org/en-US/firefox/sync/) | beudbeud |
|https://github.com/abeudin/ffsync_ynh | Firefox synchronization server | +| [FramaGames](http://framagames.org/) | polytan02 |
| https://github.com/polytan02/framagames_ynh | Set of games | | [FreshRSS](http://freshrss.org/) | plopoyop |
| https://github.com/plopoyop/freshrss_ynh | RSS reader | | [Friendica](http://friendica.com) | aymhce |
| https://github.com/aymhce/friendica_ynh | Social Communication Server | | FTP support for webapp | Maniack Crudelis |
| https://github.com/maniackcrudelis/ftp_support_webapp_ynh | FTP support for webapp | From 66345040ac653e0b62ea0984c2dc48cd1ed2e7b4 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Fri, 19 Jun 2015 13:58:13 +0200 Subject: [PATCH 030/229] Update sitemap_fr.md --- sitemap_fr.md | 46 ++++++++++++++++++++++++++-------------------- 1 file changed, 26 insertions(+), 20 deletions(-) diff --git a/sitemap_fr.md b/sitemap_fr.md index 19bf1d23..49c35c3e 100644 --- a/sitemap_fr.md +++ b/sitemap_fr.md @@ -31,32 +31,38 @@ * [Installation manuelle](/install_manually_fr) * [Brancher et démarrer votre serveur](/plug_and_boot_fr) * [Post-installation](/postinstall_fr) - * [Diagnostic du bon fonctionnement du YunoHost](/diagnostic_fr) - * [DNS - Système de nom de domaine](/dns_fr) - * [Bureaux d’enregistrements de nom de domaine - Registrar](registar_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 registar](/dns_config_fr) + * [Chez OVH](/OVH_fr) + * [Bureaux d’enregistrements de nom de domaine — Registrar](registar_fr) * [Utiliser le résolveur DNS de YunoHost](/dns_resolver_fr) - * [Configurer un DNS dynamique avec une adresse IP dynamique](dns_dynamicip_fr) - * [Avec OVH](/OVH_fr) - * [Accéder à son domaine depuis le réseau local](/dns_local_network_fr) - * [Applications officielles](/apps_fr) - * [Mettre à jour ses applications](app_update_fr) + * [Adresse IP dynamique : configuration d’un DynDNS](dns_dynamicip_fr) + * [Accéder à son serveur dans son réseau local](/dns_local_network_fr) * [Fournisseurs d’accès à Internet](/isp_fr) - * [Configuration générale box](/isp_box_config_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) - * [Free](/isp_free_fr) - * [Administration web](/admin_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) + * [Changer le mot de passe d'administration](/change_admin_password_fr) + * [Courier électronique](email_fr) + * [Formulaires pour enlever son adresse IP des listes noires](blacklist_forms_fr) + * [DKIM](dkim_fr) + * Certificats + * [Ajouter un certificat d’une autorité](/certificate_fr) + * [Régénérer le certificat auto-signé](/regenerate_certificate_fr) * [Sécurité](/security_fr) * [Guide de dépannage](/troubleshooting_guide_en) - * [Connexion à son serveur en ligne de commande avec SSH](/ssh_fr) - * [Administration en ligne de commande avec la Moulinette](/moulinette_fr) - * [Changer le mot de passe d'administration](/change_admin_password_fr) - * [Courier électronique](email_fr) - * [Formulaires pour enlever son IP des listes noires](blacklist_forms_fr) - * [DKIM](dkim_fr) - * [Gestion du certificat](/certificate_fr) - * [Régénérer un certificat](/regenerate_certificate_fr) * [YunoHost service caché Tor](/torhiddenservice_fr) * [Débloquer une IP avec Fail2ban](/fail2ban_fr) @@ -80,7 +86,7 @@ * [Liste de proposition d'applications](/apps_wishlist_fr) * [Création de paquets système](/build_system_fr) * [Création de paquets Debian](/build_packages_fr) - * [Créer une live usb](/create_live_usb_fr) + * [Créer une image live USB](/create_live_usb_fr) * [Builder Openresty](/build_openresty_fr) * Documentation * [Création d’un compte pour l’édition de la documentation](/accounting_fr) From 600ebd90624e0e8a99d5928c0eeedc7ea37c0c56 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Fri, 19 Jun 2015 13:58:52 +0200 Subject: [PATCH 031/229] Update sitemap.md --- sitemap.md | 50 ++++++++++++++++++++++++++++---------------------- 1 file changed, 28 insertions(+), 22 deletions(-) diff --git a/sitemap.md b/sitemap.md index e4fe361d..7650cd1f 100644 --- a/sitemap.md +++ b/sitemap.md @@ -7,17 +7,17 @@ * [Documentation](/docs) * Try YunoHost - * [With demo](/try) - * [With live usb](/try_at_home) + * [With the demo](/try) + * [With a live USB stick](/try_at_home) * [Administrator guide](/admindoc) * [Self-hosting](/selfhosting_en) * [Hardware compatible](/hardware) * [Installation guide](/install) - * [On the Internet Brick](/install_brick_en) + * [On the Internet Cube](/install_brick_en) * [On a Raspberry Pi](/install_on_raspberry) * [On a Cubieboard](/install_on_cubieboard) - * [From ISO](/install_iso) + * [From an ISO](/install_iso) * [On Debian](/install_on_debian) * [On VirtualBox](/install_on_virtualbox) * [On Docker](/docker) @@ -31,28 +31,34 @@ * [Manual instalation](/install_manually) * [Plug and boot your server](/plug_and_boot) * [Post-instalation](/postinstall) - * [Diagnostic](/diagnostic) - * [DNS Settings](/dns) + * Access to YunoHost server: DNS, domain name, `hosts` file + * [Diagnostic the access to YunoHost server](/diagnostic) + * [DNS Settings](/dns) * [Registrar](registar) * [DNS Configuration](/dns_config) * [Use the YunoHost DNS resolver](/dns_resolver_en) - * [Configure a dynamic DNS with a dynamic IP address](dns_dynamicip_en) + * [Dynamic IP address: configure DynDNS](dns_dynamicip_en) * [Access his server on his local network](/dns_local_network_en) - * [Official applications](/apps) - * [Update aplications](app_update_en) * [Internet service provider](/isp) - * [Main configuration box](/isp_box_config) - * [Web administration](/admin) + * [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 + * [Forms to remove blacklisting of your IP address](blacklist_forms_en) + * [DKIM](dkim) + * Certificates + * [Add a certificate certified by an authority](/certificate) + * [Regenerate self-signed certificate](/regenerate_certificate_en) * [Security](/security) * [Troubleshooting guide](/troubleshooting_guide_en) - * [Connect to your server with SSH](/ssh) - * [Command line administration](/moulinette) - * [Change administration password](/change_admin_password) - * Email: - * [Forms to remove blacklisting of his IP address](blacklist_forms_en) - * [DKIM](dkim) - * [Certificates](/certificate) - * [Regenerate certificate](/regenerate_certificate_en) * [YunoHost Tor Hidden Servicer](/torhiddenservice) * [Unblock an IP address with Fail2ban](/fail2ban_en) @@ -71,11 +77,11 @@ * [Contributor guide](/contribute) * Developement * [Package new application](/packaging_apps) - * [Packages in progress](/apps_in_progress_en) - * [Applications wishlist](/apps_wishlist_en) + * [Applications in progress](/apps_in_progress_en) + * [Wishlist of applications](/apps_wishlist_en) * [Creation of system packages](/build_system_en) * [Creation of Debian packages](/build_packages_en) - * [Create live usb](/create_live_usb) + * [Create a live USB image](/create_live_usb) * [Build Openresty](/build_openresty) * Documentation * [Write documentation](/write_documentation) From 85e4f2e1004fd8f08112d4ccd27ad887653ad219 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 11:26:51 +0200 Subject: [PATCH 032/229] Update isp_fr.md --- isp_fr.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/isp_fr.md b/isp_fr.md index 256fe987..4587f485 100644 --- a/isp_fr.md +++ b/isp_fr.md @@ -10,21 +10,21 @@ Un « **non** » peut entraîner des problèmes d’utilisation de votre serve Tous les fournisseurs d’accès à Internet [membres de la Fédération French Data Network](http://www.ffdn.org/fr/membres) ont une politique favorable à l’auto-hébergement. -| Fournisseur d'accès | Box (modem/routeur) | uPnP activable | [Port 25 ouvrable](email_fr) | [Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning) | Reverse DNS personnalisable | IP fixe | -| --- | --- | --- | --- | --- | --- | --- | -| **[Free](/isp_free_fr)** | Freebox | oui (activé) | oui (fermé) | oui (désactivé) | oui | oui | -| **[SFR](/isp_sfr_fr)** | Neufbox | oui (activé) | oui (fermé) | oui et **non** | … | oui et **non** | -| **[Orange](/isp_orange_fr)** | Livebox | oui | **non** | **non** | **non** | **non** (Professionel uniquement) | -| **Bouygues Télécom** | Bbox | oui (activé) | oui | oui | **non** | oui | -| **Numéricable** | … | oui | oui | … | **non** | **non** (Pro uniquement ?) | -| **Darty** | Dartybox | oui (activé) | oui | oui | **non** | oui | +| Fournisseur d’accès | Box/ routeur | uPnP activable | [Port 25 ouvrable](email_fr) | [Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning) | [Reverse DNS](https://en.wikipedia.org/wiki/Reverse_DNS_lookup) | [IP fixe](/dns_dynamicip_fr) | IPv6 | +| --- | --- | --- | --- | --- | --- | --- | --- | +| **[Free](/isp_free_fr)** | Freebox | oui (activé) | oui (fermé) | oui (désactivé) | oui | oui | oui | +| **[SFR](/isp_sfr_fr)** | Neufbox | oui (activé) | oui (fermé) | oui et **non** | … | oui et **non** | oui | +| **[Orange](/isp_orange_fr)** | Livebox | oui | **non** | **non** | **non** | **non** (Pro. uniquement) | … | +| **Bouygues Télécom** | Bbox | oui (activé) | oui | oui | **non** | oui | … | +| **Numéricable** | … | oui | oui | … | **non** | **non** (Pro. uniquement) | … | +| **Darty** | Dartybox | oui (activé) | oui | oui | **non** | oui | … | Pour une liste plus complète et précise, référez-vous à la très bonne documentation de [wiki.auto-hebergement.fr](http://wiki.auto-hebergement.fr/fournisseurs/fai#d%C3%A9tail_des_fai). **Astuce** : [FDN](http://www.fdn.fr) fournit des [VPN](http://www.fdn.fr/-VPN-.html) permettant de rapatrier une (ou plusieurs sur demande) IPv4 fixe et un /48 en IPv6 et ainsi “nettoyer” votre connexion si vous êtes chez l’un des FAI *limitants* du tableau ci-dessus. ### Belgique -| Fournisseur d'accès | Box (modem/routeur) | uPnP activable | [Port 25 ouvrable](email_fr)| [Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning) | Reverse DNS personnalisable | IP fixe | +| Fournisseur d’accès | Box/ routeur | uPnP activable | [Port 25 ouvrable](email_fr)| [Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning) | [Reverse DNS](https://en.wikipedia.org/wiki/Reverse_DNS_lookup) | IP fixe | | --- | --- | --- | --- | --- | --- | --- | | **Belgacom** | BBox2 | oui (activé) | oui | **non** | **non** | **non** | | **Scarlet** | BBox2 | oui (activé) | oui | **non** | **non** | **non** | From 6ff4dd7c224c2f6b0a29d50b2297901096b5a995 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 12:47:56 +0200 Subject: [PATCH 033/229] Update isp_box_config.md --- isp_box_config.md | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/isp_box_config.md b/isp_box_config.md index 4ba64c2d..9aa93367 100644 --- a/isp_box_config.md +++ b/isp_box_config.md @@ -1,29 +1,31 @@ -#Configuration box/router +# Configuration box/router -####Access to box/routeur administration +#### Access to box/routeur administration In the URL bar of your web navigator put: ```bash 192.168.0.1 or 192.168.1.1 ``` Then you will need to authentificate. -####Opening ports +#### Opening ports Opening following ports are necessary to make works differents services. -TCP : 22, 25, 53, 80, 443, 465, 993, 5222, 5269, 5290 +**TCP:** +* Web: 80, 443 +* [SSH](/ssh_en): 22 +* [XMPP](/XMPP_en): 5222, 5269 +* [Email](/email_en): 25, 465, 993 +* [DNS](/dns_en): 53 -#####UPnP +##### UPnP +UPnP permit opening automatically ports. -L’UPnP permit opening automatically ports. - -In some case, after changing your box configuration (ex: add IPv6, or unlock SMTP ... ) and a reboot. It happens that ports are no onger opened. So you have to reload your firewall configuration : +In some case, after changing your box configuration (ex: add IPv6, or unlock SMTP ... ) and a reboot. It happens that ports are no onger opened. So you have to reload your firewall configuration: ```sudo yunohost firewall reload``` -#####Manual opening ports - +##### Manual opening ports In the case that UPnP doesn’t works, manual opening ports are necessary. -#####Email - +##### Email Internet service porviders blocks port 25 to avoid spam. To send mails, you’ll need to open port 25. From 22f230d19083eddac92e0ed33fffa6f9a0eaf439 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 13:44:25 +0200 Subject: [PATCH 034/229] Add email_migration.md --- email_migration.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 email_migration.md diff --git a/email_migration.md b/email_migration.md new file mode 100644 index 00000000..0cb935d9 --- /dev/null +++ b/email_migration.md @@ -0,0 +1,37 @@ +# Migrate his emails + +*[Documentation linked to YunoHost email](/email_fr)*. + +Migration of his emails from a server to an other can be done with two recommended tools: ImapSync or Larch. + +This tool must be installed on your desktop computer. The transfer method looks at this schema: + +**`Old email server −> desktop computer with ImapSync or Larch −> new email server`** + +### ImapSync +[ImapSync site](http://imapsync.lamiral.info/) + +Install ImapSync on your client computer by following this [guide](http://imapsync.lamiral.info/INSTALL): +```bash +sudo dnf install imapsync # Under Fedora +``` +Transfer emails from a server to an other: +```bash +imapsync --host1 --port1 993 --ssl1 --user1 --password1 \ +--host2 --port2 993 --ssl2 --user2 --password2 +``` + +Note that transfer settings `--port 993` and `--ssl` are specific to YunoHost email server. + +### Larch +[Larch site](https://github.com/rgrove/larch/) + +After beforehand installed `gem`, install `larch` on your client computer: +```bash +sudo gem install larch +``` +Transfer emails from a server to an other: +```bash +larch -a -f imaps://serveur_d'origine.org -t imaps://serveur_de_destination.org +``` +For other type of tranfer refer you to Larch documentation. \ No newline at end of file From 5c3f9737c6a7e4eb5bceecfc6f403be62e81cf6b Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 13:44:54 +0200 Subject: [PATCH 035/229] Add email_migration_fr.md --- email_migration_fr.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 email_migration_fr.md diff --git a/email_migration_fr.md b/email_migration_fr.md new file mode 100644 index 00000000..48e68388 --- /dev/null +++ b/email_migration_fr.md @@ -0,0 +1,37 @@ +# Migration de ces emails + +*[Documentation en rapport avec l’email de YunoHost](/email_fr)*. + +La migration des emails d’un serveur à un autre peux se faire via deux outils recommandés : ImapSync ou Larch. + +Cet outil doit être installé sur votre ordinateur de bureau. La procédure de transfert est comme sur le schéma : + +**`Ancien serveur email −> ordinateur client avec ImapSync ou Larch −> nouveau serveur email`** + +### ImapSync +[Site d’ImapSync](http://imapsync.lamiral.info/) + +Installez ImapSync sur votre ordinateur client en suivant ce [guide](http://imapsync.lamiral.info/INSTALL) : +```bash +sudo dnf install imapsync # Sous Fedora +``` +Transferez les mails d’un serveur à l’autre : +```bash +imapsync --host1 --port1 993 --ssl1 --user1 --password1 \ +--host2 --port2 993 --ssl2 --user2 --password2 +``` + +Notez que les paramètres de transfert `--port 993` et `--ssl` sont spécifique à un serveur de mail YunoHost. + +### Larch +[Site de Larch](https://github.com/rgrove/larch/) + +Après avoir préalablement installé `gem`, installez `larch` sur votre ordinateur client : +```bash +sudo gem install larch +``` +Transferez les mails d’un serveur à l’autre : +```bash +larch -a -f imaps://serveur_d'origine.org -t imaps://serveur_de_destination.org +``` +Pour d’autres types de transferts référez-vous à la documentation de Larch. From c8a8f94fa14154df1096ef85b559429e41f3d134 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 14:05:05 +0200 Subject: [PATCH 036/229] Update isp_fr.md --- isp_fr.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/isp_fr.md b/isp_fr.md index 4587f485..e8168011 100644 --- a/isp_fr.md +++ b/isp_fr.md @@ -11,12 +11,11 @@ Un « **non** » peut entraîner des problèmes d’utilisation de votre serve Tous les fournisseurs d’accès à Internet [membres de la Fédération French Data Network](http://www.ffdn.org/fr/membres) ont une politique favorable à l’auto-hébergement. | Fournisseur d’accès | Box/ routeur | uPnP activable | [Port 25 ouvrable](email_fr) | [Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning) | [Reverse DNS](https://en.wikipedia.org/wiki/Reverse_DNS_lookup) | [IP fixe](/dns_dynamicip_fr) | IPv6 | -| --- | --- | --- | --- | --- | --- | --- | --- | +| :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | | **[Free](/isp_free_fr)** | Freebox | oui (activé) | oui (fermé) | oui (désactivé) | oui | oui | oui | | **[SFR](/isp_sfr_fr)** | Neufbox | oui (activé) | oui (fermé) | oui et **non** | … | oui et **non** | oui | -| **[Orange](/isp_orange_fr)** | Livebox | oui | **non** | **non** | **non** | **non** (Pro. uniquement) | … | -| **Bouygues Télécom** | Bbox | oui (activé) | oui | oui | **non** | oui | … | -| **Numéricable** | … | oui | oui | … | **non** | **non** (Pro. uniquement) | … | +| **[Orange](/isp_orange_fr)** | Livebox | oui | **non** | **non** | **non** | **non** (Pro. uniquement) | oui | +| **Bouygues Télécom** | Bbox | oui (activé) | oui | oui | **non** | oui | oui | | **Darty** | Dartybox | oui (activé) | oui | oui | **non** | oui | … | Pour une liste plus complète et précise, référez-vous à la très bonne documentation de [wiki.auto-hebergement.fr](http://wiki.auto-hebergement.fr/fournisseurs/fai#d%C3%A9tail_des_fai). @@ -25,6 +24,6 @@ Pour une liste plus complète et précise, référez-vous à la très bonne docu ### Belgique | Fournisseur d’accès | Box/ routeur | uPnP activable | [Port 25 ouvrable](email_fr)| [Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning) | [Reverse DNS](https://en.wikipedia.org/wiki/Reverse_DNS_lookup) | IP fixe | -| --- | --- | --- | --- | --- | --- | --- | +| :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | | **Belgacom** | BBox2 | oui (activé) | oui | **non** | **non** | **non** | | **Scarlet** | BBox2 | oui (activé) | oui | **non** | **non** | **non** | From 3d7221186eba00a83030971943ab746b789be491 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 14:15:14 +0200 Subject: [PATCH 037/229] Add email_configure_client.md --- email_configure_client.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 email_configure_client.md diff --git a/email_configure_client.md b/email_configure_client.md new file mode 100644 index 00000000..47fc6161 --- /dev/null +++ b/email_configure_client.md @@ -0,0 +1,26 @@ +## Configuration desktop email client + +*[Documentation linked to YunoHost email](/email_fr)*. + +You can access your emails via desktop email clients such as Mozilla Thunderbird. + +#### Requirements +* Email address +* Password of the user account + +##### Settings +| Protocol | Port | Encryption | +| :--: | :-: | :--: | +| IMAP | 993 | SSL/TLS | +| SMTP | 465 | SSL/TLS | + +#### Mozilla Thunderbird + +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. \ No newline at end of file From 6424cd591fbbaec7247f9092784b7c1c5a5b8252 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 14:15:39 +0200 Subject: [PATCH 038/229] Add email_configure_client_fr.md --- email_configure_client_fr.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 email_configure_client_fr.md diff --git a/email_configure_client_fr.md b/email_configure_client_fr.md new file mode 100644 index 00000000..f465ddfe --- /dev/null +++ b/email_configure_client_fr.md @@ -0,0 +1,25 @@ +## Configuration client email de bureau + +*[Documentation en rapport avec l’email de YunoHost](/email_fr)*. + +Il est possible d’accéder à ses emails grâce à un client lourd de messagerie électronique tel que Mozilla Thunderbird. + +#### Prérequis +* Adresse email principal +* Mot de passe du compte utilisateur + +#### Réglages génériques +| Protocole | Port | Chiffrement | +| :--: | :-: | :--: | +| IMAP | 993 | SSL/TLS | +| SMTP | 465 | SSL/TLS | + +#### 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. + + + +* [Gestion des alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases) + +#### Pour Android +L’application [K-9 Mail](https://github.com/k9mail) fonctionne. \ No newline at end of file From bfafd7a02b9e5695f8b172540e47e400a67cdf29 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 14:27:20 +0200 Subject: [PATCH 039/229] Update email.md --- email.md | 62 ++++++++++---------------------------------------------- 1 file changed, 11 insertions(+), 51 deletions(-) diff --git a/email.md b/email.md index b1d70927..0e4cb844 100644 --- a/email.md +++ b/email.md @@ -1,55 +1,15 @@ # Email -YunoHost provides: +### Summary +* [Configure email client](email_configure_client_en) +* [MX DNS zone](/dns_config_en) +* [Open ports on the router](/isp_box_config_en) +* [Migrate emails](email_migration_en) +* [Forms to remove blacklisting of your IP address](blacklist_forms_en) +* [Use DKIM](dkim_en) + +#### YunoHost provides * [Postfix](http://www.postfix.org/): a SMTP email server -* [Dovecot](http://www.dovecot.org/): a IMAP and a POP3 email server +* [Dovecot](http://www.dovecot.org/): an IMAP email server * [Amavis](http://amavis.org/): an antispam -* [RoundCube](/apps): a webmail - -### Desktop email client -You can access your emails via desktop email clients such as Mozilla Thunderbird or Evolution. - -You will need your email address and your password. - -**Caution:** your login is your SSO username and not your email address - -##### Settings: - -`IMAP | 993 | SSL/TLS` - -`SMTP | 465 | SSL/TLS` - -#### Mozilla Thunderbird - -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. - -### Migration -Emails can be migrated with: -* [ImapSync](http://imapsync.lamiral.info/): - * on your client [install ImapSync](http://imapsync.lamiral.info/INSTALL): -```bash -sudo dnf install imapsync # Under Fedora -``` - * Proceed to the transfert between two YunoHost servers: -```bash -imapsync --host1 --port1 993 --ssl1 --user1 --password1 \ ---host2 --port2 993 --ssl2 --user2 --password2 -``` -* [Larch](https://github.com/rgrove/larch/): - * on your client install Larch: -```bash -sudo gem install larch -``` - * Proceed to the transfert between two YunoHost servers: -```bash -larch -a -f imaps://serveur_d'origine.org -t imaps://serveur_de_destination.org -``` -For other type of tranfers refer you to Larch documentation. - +* [RoundCube](/apps): a webmail \ No newline at end of file From 7a874e150706a8bc07587bddf5a628729f072ecf Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 14:27:47 +0200 Subject: [PATCH 040/229] Update email_fr.md --- email_fr.md | 59 +++++++++-------------------------------------------- 1 file changed, 10 insertions(+), 49 deletions(-) diff --git a/email_fr.md b/email_fr.md index 19615d85..52d94ad5 100644 --- a/email_fr.md +++ b/email_fr.md @@ -1,57 +1,18 @@ # Messagerie électronique -YunoHost fournit : +### Sommaire +* [Configuration un client email](email_configure_client_fr) +* [Zone DNS MX](/dns_config_fr) +* [Ouverture des ports de la box](/isp_box_config_fr) +* [Migration emails](email_migration_fr) +* [Formulaires pour enlever son adresse IP des listes noires](blacklist_forms_fr) +* [Mise en place DKIM](dkim_fr) + +#### YunoHost fournit * [Postfix](http://www.postfix.org/) : un serveur de messagerie électronique SMTP -* [Dovecot](http://www.dovecot.org/) : un serveur de messagerie électronique IMAP et POP3 +* [Dovecot](http://www.dovecot.org/) : un serveur de messagerie électronique IMAP * [Amavis](http://amavis.org/) : un antispam * [RoundCube](/apps) : un webmail -### Client lourd de messagerie électronique -Il est possible d’accéder à ses courriels grâce à un client lourd de messagerie électronique comme Mozilla Thunderbird ou Évolution. - -L’adresse mail principale et ton mot de passe sont nécessaire. - -**Attention:** votre login est votre nom d’utilisateur SSO et non votre adresse mail ou la partie avant le @ - -##### Réglages : - -`IMAP | 993 | SSL/TLS` - -`SMTP | 465 | SSL/TLS` - -#### Mozilla Thunderbird -L’utilitaire de détection automatique de Thunderbird ne marche pas correctement avec YunoHost. Il faut donc passer en configuration manuelle. N’oubliez pas d’enlever le point devant le nom domaine. - - - -* [Gestion des alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases) - -#### Pour Android -L’application [K-9 Mail](https://github.com/k9mail) fonctionne. - -### Migration -Les emails peuvent être migrés avec : -* [ImapSync](http://imapsync.lamiral.info/) : - * sur votre client [installez ImapSync](http://imapsync.lamiral.info/INSTALL) : -```bash -sudo dnf install imapsync # Sous Fedora -``` - * Procédez au transfert ente deux serveurs YunoHost : -```bash -imapsync --host1 --port1 993 --ssl1 --user1 --password1 \ ---host2 --port2 993 --ssl2 --user2 --password2 -``` -* [Larch](https://github.com/rgrove/larch/) : - * sur votre client installez Larch : -```bash -sudo gem install larch -``` - * Procédez au transfert ente deux serveurs YunoHost : -```bash -larch -a -f imaps://serveur_d'origine.org -t imaps://serveur_de_destination.org -``` -Pour d’autres types de transferts référez-vous à la documentation de Larch. - #### Aller plus loin - * [Conférence de Benjamin Sonntag - L’email](http://www.iletaitunefoisinternet.fr/lemail-par-benjamin-sonntag/) From b3db4e314cece1b6d18b2f56402ee08f58e63b7a Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 14:28:21 +0200 Subject: [PATCH 041/229] Update sitemap.md --- sitemap.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/sitemap.md b/sitemap.md index 7650cd1f..ebfe1298 100644 --- a/sitemap.md +++ b/sitemap.md @@ -51,9 +51,11 @@ * [Command line administration](/moulinette) * [Web administration](/admin) * [Change administration password](/change_admin_password) - * Email + * [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) - * [DKIM](dkim) + * [Use DKIM](dkim) * Certificates * [Add a certificate certified by an authority](/certificate) * [Regenerate self-signed certificate](/regenerate_certificate_en) @@ -64,7 +66,7 @@ * [User guide](/userdoc) * [User interface](user_interface) - * [Configure an email client](/email) + * [Configure email client](email_configure_client_en) * [Instant messaging usage](/XMPP) * [Official applications](/apps) * [Baikal](/app_baikal_en) From 500910cc1e46bfa09c35904915521e5c60cc359e Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 14:28:52 +0200 Subject: [PATCH 042/229] Update sitemap_fr.md --- sitemap_fr.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/sitemap_fr.md b/sitemap_fr.md index 49c35c3e..14485c01 100644 --- a/sitemap_fr.md +++ b/sitemap_fr.md @@ -56,8 +56,10 @@ * [Administration web](/admin_fr) * [Changer le mot de passe d'administration](/change_admin_password_fr) * [Courier électronique](email_fr) + * [Configuration un client email](email_configure_client_fr) + * [Migration emails](email_migration_fr) * [Formulaires pour enlever son adresse IP des listes noires](blacklist_forms_fr) - * [DKIM](dkim_fr) + * [Mise en place de DKIM](dkim_fr) * Certificats * [Ajouter un certificat d’une autorité](/certificate_fr) * [Régénérer le certificat auto-signé](/regenerate_certificate_fr) @@ -68,7 +70,7 @@ * [Guide de l'utilisateur](/userdoc_fr) * [Interface utilisateur](user_interface) - * [Configurer un client email](/email_fr) + * [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) From 6fbbc026a1809297c6837a8634f92c397d26fd06 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 14:42:37 +0200 Subject: [PATCH 043/229] Update email_fr.md --- email_fr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/email_fr.md b/email_fr.md index 52d94ad5..03ed01c9 100644 --- a/email_fr.md +++ b/email_fr.md @@ -1,12 +1,12 @@ # Messagerie électronique ### Sommaire -* [Configuration un client email](email_configure_client_fr) +* [Configuration d’un client email](email_configure_client_fr) * [Zone DNS MX](/dns_config_fr) * [Ouverture des ports de la box](/isp_box_config_fr) * [Migration emails](email_migration_fr) * [Formulaires pour enlever son adresse IP des listes noires](blacklist_forms_fr) -* [Mise en place DKIM](dkim_fr) +* [Mettre en place DKIM](dkim_fr) #### YunoHost fournit * [Postfix](http://www.postfix.org/) : un serveur de messagerie électronique SMTP From faffa6d8db57441020296dc31c1e84495480a2dc Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 14:42:41 +0200 Subject: [PATCH 044/229] Update sitemap_fr.md --- sitemap_fr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sitemap_fr.md b/sitemap_fr.md index 14485c01..e43b0a69 100644 --- a/sitemap_fr.md +++ b/sitemap_fr.md @@ -56,10 +56,10 @@ * [Administration web](/admin_fr) * [Changer le mot de passe d'administration](/change_admin_password_fr) * [Courier électronique](email_fr) - * [Configuration un client email](email_configure_client_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) - * [Mise en place de DKIM](dkim_fr) + * [Mettre en place DKIM](dkim_fr) * Certificats * [Ajouter un certificat d’une autorité](/certificate_fr) * [Régénérer le certificat auto-signé](/regenerate_certificate_fr) From 060130c154eaf47a42d67c158e5557b12255a933 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 20 Jun 2015 15:36:36 +0200 Subject: [PATCH 045/229] Update isp_fr.md --- isp_fr.md | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/isp_fr.md b/isp_fr.md index e8168011..a2c9d138 100644 --- a/isp_fr.md +++ b/isp_fr.md @@ -8,15 +8,19 @@ Un « **non** » peut entraîner des problèmes d’utilisation de votre serve ### France -Tous les fournisseurs d’accès à Internet [membres de la Fédération French Data Network](http://www.ffdn.org/fr/membres) ont une politique favorable à l’auto-hébergement. +Tous les fournisseurs d’accès à Internet [membres de la Fédération French Data Network](http://www.ffdn.org/fr/membres) ont une politique favorable à l’auto-hébergement. +* ✔ : oui +* ✘ : non -| Fournisseur d’accès | Box/ routeur | uPnP activable | [Port 25 ouvrable](email_fr) | [Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning) | [Reverse DNS](https://en.wikipedia.org/wiki/Reverse_DNS_lookup) | [IP fixe](/dns_dynamicip_fr) | IPv6 | -| :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | -| **[Free](/isp_free_fr)** | Freebox | oui (activé) | oui (fermé) | oui (désactivé) | oui | oui | oui | -| **[SFR](/isp_sfr_fr)** | Neufbox | oui (activé) | oui (fermé) | oui et **non** | … | oui et **non** | oui | -| **[Orange](/isp_orange_fr)** | Livebox | oui | **non** | **non** | **non** | **non** (Pro. uniquement) | oui | -| **Bouygues Télécom** | Bbox | oui (activé) | oui | oui | **non** | oui | oui | -| **Darty** | Dartybox | oui (activé) | oui | oui | **non** | oui | … | +| Fournisseur d’accès | [Free](/isp_free_fr) | [SFR](/isp_sfr_fr) | [Orange](/isp_orange_fr) | Bouygues
Télécom | Darty | +| :---: | :---: | :---: | :---: | :---: | :---: | +| **Box/routeur** | Freebox | Neufbox | Livebox | Bbox | Dartybox | +| **[UPnP](https://fr.wikipedia.org/wiki/Universal_Plug_and_Play)** | ✔ | ✔ | ✔ | ✔ | ✔ | +| **[Port 25 ouvrable](email_fr)**
(fermé par défaut) | ✔ | ✔ | ✘ | ✔ | ✔ | +| **[Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning)** | ✔ | ✔/✘ | ✘ | ✔ | ✔ | +| **[Reverse DNS](https://en.wikipedia.org/wiki/Reverse_DNS_lookup)
personnalisable ** | ✔ | … | ✘ | ✘ | ✘ | +| **[IP fixe](/dns_dynamicip_fr)** | ✔ | ✔/✘ | ✘ | ✔ | ✔ | +| **[IPv6](https://fr.wikipedia.org/wiki/IPv6)** | ✔ | ✔ | ✔ | … | … | Pour une liste plus complète et précise, référez-vous à la très bonne documentation de [wiki.auto-hebergement.fr](http://wiki.auto-hebergement.fr/fournisseurs/fai#d%C3%A9tail_des_fai). **Astuce** : [FDN](http://www.fdn.fr) fournit des [VPN](http://www.fdn.fr/-VPN-.html) permettant de rapatrier une (ou plusieurs sur demande) IPv4 fixe et un /48 en IPv6 et ainsi “nettoyer” votre connexion si vous êtes chez l’un des FAI *limitants* du tableau ci-dessus. From 53bdb7a44d8172ce714f22d9647df613f6927a98 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Mon, 22 Jun 2015 12:31:01 +0200 Subject: [PATCH 046/229] Update packaging_apps_fr.md --- packaging_apps_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packaging_apps_fr.md b/packaging_apps_fr.md index f2bd5803..a02f8771 100644 --- a/packaging_apps_fr.md +++ b/packaging_apps_fr.md @@ -17,7 +17,7 @@ Un paquet YunoHost est composé : * d’un fichier `LICENSE` contenant la licence du paquet * d’une page de présentation du paquet contenu dans un fichier `README.md` -**[Paquet de base](https://github.com/opi/example_ynh)** : n'hésitez pas à vous en servir comme base de travail. +**[Paquet de base](https://github.com/YunoHost/example_ynh)** : n'hésitez pas à vous en servir comme base de travail. ### Manifeste Le fichier `manifest.json` définit les constantes de l'application, un ensemble de valeurs dont YunoHost a besoin pour identifier l'application et l'installer correctement. Voici un exemple : From b92c3b20f3a6a2e89501300900111c310c5961e3 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Mon, 22 Jun 2015 12:32:58 +0200 Subject: [PATCH 047/229] Update packaging_apps.md --- packaging_apps.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packaging_apps.md b/packaging_apps.md index db973007..679df6d1 100644 --- a/packaging_apps.md +++ b/packaging_apps.md @@ -17,7 +17,7 @@ A YunoHost package is composed of: * A `LICENSE` file containing the license of the package * A presentation page of your package in a `README.md` file -**[A basic package](https://github.com/opi/example_ynh)**: feel free to use it as a framework. +**[A basic package](https://github.com/YunoHost/example_ynh)**: feel free to use it as a framework. ### Manifest The `manifest.json` file defines the app's constants, a bunch of values that YunoHost needs to identify the app and install it correctly. It looks like this : From 60b6928c23be3200d177cb6a4077ba9480b3d955 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 24 Jun 2015 17:28:10 +0200 Subject: [PATCH 048/229] Update ssh_fr.md --- ssh_fr.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/ssh_fr.md b/ssh_fr.md index 9841c2fa..61fe4394 100644 --- a/ssh_fr.md +++ b/ssh_fr.md @@ -2,7 +2,8 @@ Le **SSH** permet de commander à distance son serveur en ligne de commande (CLI). ##### Pour se connecter à son serveur : +```bash +ssh admin@mon-serveur.org +``` -`ssh admin@mon-serveur.org` - -Puis il faut entrer le mot de passe administrateur, celui créé à [l’étape de post-installation](postinstall_fr). +Ensuite, il est demandé le mot de passe administrateur, celui créé à [l’étape de post-installation](postinstall_fr). \ No newline at end of file From 1b3c19139a6dc1df0030c2c105302b7f1cca8068 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 24 Jun 2015 18:30:28 +0200 Subject: [PATCH 049/229] Update isp_box_config_fr.md --- isp_box_config_fr.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/isp_box_config_fr.md b/isp_box_config_fr.md index bbc0e156..1f8afb7c 100644 --- a/isp_box_config_fr.md +++ b/isp_box_config_fr.md @@ -3,6 +3,8 @@ ### Accès à l’administration de la box/routeur Allez à l’adresse suivante : http://192.168.0.1 (ou celle-ci http://192.168.1.1). Puis authentifier-vous. +### Tutoriel +* [Tutoriel pour les ouvrir les ports sur les boxs d’Orange, Free, SFR, Dartybox, Belgacom et sur les routeurs Netgear](https://craym.eu/tutoriels/utilitaires/ouvrir_les_ports_de_sa_box.html). ### Ouverture des ports L’ouverture des ports suivants est nécessaire au fonctionnement des différents services. From 5680d17b1036218b975273e0a4cc60075729cd5d Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 25 Jun 2015 22:26:15 +0200 Subject: [PATCH 050/229] Update install.md --- install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/install.md b/install.md index 999160bd..2ed492c0 100644 --- a/install.md +++ b/install.md @@ -93,7 +93,7 @@ This page lists few installation guides.

On Debian

-If you have already installed **Debian 7** (wheezy) on a server, you are able to **[install YunoHost via script](/install_on_debian)**. +If you have already installed **Debian 7** (Wheezy) or **8** (Jessie) on a server, you are able to **[install YunoHost via script](/install_on_debian)**. From 99e8ace6ca71bcb164600d4868b5cca74d5e697f Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 25 Jun 2015 22:26:47 +0200 Subject: [PATCH 051/229] Update install_fr.md --- install_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/install_fr.md b/install_fr.md index 43fe6040..7cfcf1aa 100644 --- a/install_fr.md +++ b/install_fr.md @@ -93,6 +93,6 @@ Cette page liste plusieurs types d'installations, classés par catégories.

Sur Debian

-Si vous disposez déjà d'un serveur ou d'un ordinateur sous **Debian 7** (wheezy), suivez l'**[installation par script](/install_on_debian_fr)**. +Si vous disposez déjà d'un serveur ou d'un ordinateur sous **Debian 7** (Wheezy) ou **8** (Jessie), suivez l'**[installation par script](/install_on_debian_fr)**. From 80db8050a3a42fabdc312fa24338fb6fe3f19482 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 27 Jun 2015 12:08:48 +0200 Subject: [PATCH 052/229] Add conf_fr.md --- conf_fr.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 conf_fr.md diff --git a/conf_fr.md b/conf_fr.md new file mode 100644 index 00000000..0a1e9689 --- /dev/null +++ b/conf_fr.md @@ -0,0 +1,7 @@ +# Conférences + +* [PSES 2015 - La Brique Internet](http://www.youtube.com/watch?v=NCRn0yRfkIE) +* [THSF 2015](https://vimeo.com/128055751) +* [RMLL 2014 - Hébergez-vous !]() +* [Capitole du libre 2013 - L’auto-hébergement pour tous avec YunoHost - par Adrien Beudin](http://2013.capitoledulibre.org/conferences/internet-libre/lauto-hebergement-pour-tous-avec-yunohost.html) +* [FOSDEM 2013](https://www.youtube.com/watch?v=siN1OLAgGJk) \ No newline at end of file From 4fc804dbb76b96a713402cc57c3eef8865ea4bd9 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 27 Jun 2015 12:09:12 +0200 Subject: [PATCH 053/229] Update sitemap_fr.md --- sitemap_fr.md | 1 + 1 file changed, 1 insertion(+) diff --git a/sitemap_fr.md b/sitemap_fr.md index e43b0a69..814f3096 100644 --- a/sitemap_fr.md +++ b/sitemap_fr.md @@ -102,6 +102,7 @@ * [Contributeurs](contribs_fr) * [Entraide - support](/support_fr) * [Blog](https://forum.yunohost.org/c/announcement) + * [Conférences](/conf_fr) * [Communication extérieure](communication_fr) * [Travail artistique](artworks_fr) * [Aide](/help_fr) From fff0eb5e9777355d484ed2573e4cc80b33df2b1f Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 28 Jun 2015 12:32:36 +0200 Subject: [PATCH 054/229] Update dkim_fr.md --- dkim_fr.md | 36 +++++++++++++++++++++--------------- 1 file changed, 21 insertions(+), 15 deletions(-) diff --git a/dkim_fr.md b/dkim_fr.md index f0d091dd..dac040c7 100644 --- a/dkim_fr.md +++ b/dkim_fr.md @@ -1,24 +1,22 @@ - # DKIM -Veuillez noter les points suivants : +##### Notes : -Ceci est la deuxième version de ce travail en cours concernant l'activation de DKIM et SPF dans YunoHost. - -En attendant que tout ceci soit intégré nativement dans YunoHost, cela nécessitera une modification de la configuration de Postfix dans /etc/postfix/main.cf. +* Ceci est la deuxième version de ce travail en cours concernant l'activation de [DKIM](https://fr.wikipedia.org/wiki/DomainKeys_Identified_Mail) et [SPF](https://fr.wikipedia.org/wiki/Sender_Policy_Framework) dans YunoHost. +* Le DKIM et le SPF empêche le fait que des courriels puissent être envoyer avec votre nom de domaine à partir d’un autre serveur que le serveur légitime. Ceci évite le spam. +* En attendant que tout ceci soit intégré nativement dans YunoHost, cela nécessitera une modification de la configuration de Postfix dans `/etc/postfix/main.cf`. +* Pour fonctionner correctement, DKIM nécessite une modification de votre [zone DNS](/dns_config_fr). N'oubliez pas que la propagation de l'information DNS une fois modifiée peut prendre jusqu'à 24h ! -Pour fonctionner correctement, DKIM nécessite une modification de vos DNS. N'oubliez pas que la propagation de l'information DNS une fois modifiée peut prendre jusqu'à 24h ! +##### Sources : +* Ce document a été initialement basé sur : http://sealedabstract.com/code/nsa-proof-your-e-mail-in-2-hours/ de Drew Crawford. +* Cette 2ème révision s'appuie beaucoup sur : https://www.digitalocean.com/community/tutorials/how-to-install-and-configure-dkim-with-postfix-on-debian-wheezy from Popute Sebastian Armin -Source : ce document a été initialement basé sur : http://sealedabstract.com/code/nsa-proof-your-e-mail-in-2-hours/ from Drew Crawford +Dans la suite de ce document, replacez `DOMAIN.TLD` par votre propre nom de domaine. -Source : cette 2ème révision s'appuie beaucoup sur : https://www.digitalocean.com/community/tutorials/how-to-install-and-configure-dkim-with-postfix-on-debian-wheezy from Popute Sebastian Armin +Changement dans la 2nd révision : -Dans la suite de ce document, replacez DOMAIN.TLD par votre propre nom de domaine. - -Changement dans la rev 2 : - -La config s'adapte très facilement à plusieurs noms de domaines simultanés. -Mise à jour des paramètres de configuration avec la dernière version de opendkim disponible dans Debian 7. +* La configuration s'adapte très facilement à plusieurs noms de domaines simultanés. +* Mise à jour des paramètres de configuration avec la dernière version de OpenDKIM disponible dans Debian 7. Rentrons maintenant dans le cœur du sujet : ### Avec un script @@ -155,4 +153,12 @@ sudo service opendkim restart sudo service postfix restart ``` -Pour tester que tout fonctionne bien (n'oubliez pas que la propagation DNS peut prendre jusqu'à 24h...) vous pouvez tout simplement envoyer un email à check-auth@verifier.port25.com . Vous recevrez une réponse automatiquement. Si tout se passe bien, vous verrez DKIM check: pass dans la section Summary of Results. +Pour tester que tout fonctionne bien (n'oubliez pas que la propagation DNS peut prendre jusqu'à 24h...) vous pouvez tout simplement vous rendre sur [mail-tester.com](http://www.mail-tester.com/), envoyer un courriel à l'adresse indiquée et cliquer pour voir le résultat. + +# SPF +Enfin, n'oubliez pas d'ajouter une clé SPF dans votre [zone DNS](/dns_config_fr) (ou un champ TXT si SPF n'est pas disponible) : +```bash +DOMAIN.TLD 1800 TXT "v=spf1 a:DOMAIN.TLD mx ?all" +``` + +Pour rappel, le champ SPF indique que seule la machine utilisant l'adresse IP indiquée dans votre zone DNS est autorisée à envoyer des courriels. \ No newline at end of file From c5abdf2cdfda233be6ccd24f227024fed0eb0693 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 28 Jun 2015 12:33:37 +0200 Subject: [PATCH 055/229] Update dkim.md --- dkim.md | 34 +++++++++++++++------------------- 1 file changed, 15 insertions(+), 19 deletions(-) diff --git a/dkim.md b/dkim.md index 17c164cd..7d7f4eb8 100644 --- a/dkim.md +++ b/dkim.md @@ -1,21 +1,17 @@ # DKIM +##### Note: +* This is the 2nd revision of this Work In Progress How-To activate [DKIM](https://en.wikipedia.org/wiki/DomainKeys_Identified_Mail) and [SPF](https://en.wikipedia.org/wiki/Sender_Policy_Framework) in YunoHost. +* Le DKIM and SPF prevent emails which could be sent with your domain name from a non legitim server. This avoid spam. +* Untill, this is not natively integrated in YunoHost core, it will mean to that Postfix configuration will be blocked (or each time there is a change some configuration lines will need to be added to the end of `/etc/postfix/main.cf`). +* To be fully functionnal DKIM requires a modification of your [DNS zone](/dns_config_en), which propagantion can take up to 24h. -Please note that : +##### Sources: +* This tutorial has been initially based on the DKMI section of: http://sealedabstract.com/code/nsa-proof-your-e-mail-in-2-hours/ from Drew Crawford. +* This tutorial has been reviewed based on https://www.digitalocean.com/community/tutorials/how-to-install-and-configure-dkim-with-postfix-on-debian-wheezy from Popute Sebastian Armin -This is the revision 2 of this Work In Progress How-To. - -Until this is natively integrated in YunoHost core apps, it will mean to that Postfix configuration will be blocked (or each time there is a change some configuration lines will need to be added to the end of /etc/postfix/main.cf). - -To be fully functionnal DKIM requires a modification of the DNS, which propagantion can take up to 24h. - -Source: This tutorial has been initially based on the DKMI section of: http://sealedabstract.com/code/nsa-proof-your-e-mail-in-2-hours/ from Drew Crawford. - -Source: This tutorial has been reviewed based on https://www.digitalocean.com/community/tutorials/how-to-install-and-configure-dkim-with-postfix-on-debian-wheezy from Popute Sebastian Armin - -Replace DOMAIN.TLD by your own domain name. - -Changes in rev 2: +Replace `DOMAIN.TLD` by your own domain name. +Changes in 2n revision: Much easier to manage more than one DOMAIN.TLD (future proof). Updated configuration as it seemed that the previous one was based on old software. @@ -153,12 +149,12 @@ sudo service opendkim restart sudo service postfix restart ``` -To test if it is all working well (don't forget that the DNS propagation can take a bit of take…) you can simply send an email to check-auth@verifier.port25.com and a reply will be received. If everything works correctly you should see DKIM check: pass under Summary of Results. - -You can also go to http://www.mail-tester.com - -Lastly, don't forget to add a SPF key in your DNS such as: +To test if it is all working well (don't forget that the DNS propagation can take a bit of take…) you can simply go to [mail-tester.com](http://www.mail-tester.com) and send an e-mail to the address indicated. Then follow the link and the result will appear. + +# SPF +Lastly, don't forget to add a SPF key in your [DNS zone](/dns_config_en) such as: ```bash DOMAIN.TLD 300 TXT "v=spf1 a:DOMAIN.TLD mx ?all" ``` +As reminder, the SPF field shows that the only machine using the IP address shows in your DNS zone are authorized to send emails. \ No newline at end of file From 25a6bcd0af57285ff3ed3b1d99d3beda3b330c1f Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 28 Jun 2015 13:29:37 +0200 Subject: [PATCH 056/229] Update dkim_fr.md --- dkim_fr.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/dkim_fr.md b/dkim_fr.md index dac040c7..51cf1b76 100644 --- a/dkim_fr.md +++ b/dkim_fr.md @@ -157,8 +157,10 @@ Pour tester que tout fonctionne bien (n'oubliez pas que la propagation DNS peut # SPF Enfin, n'oubliez pas d'ajouter une clé SPF dans votre [zone DNS](/dns_config_fr) (ou un champ TXT si SPF n'est pas disponible) : -```bash -DOMAIN.TLD 1800 TXT "v=spf1 a:DOMAIN.TLD mx ?all" -``` -Pour rappel, le champ SPF indique que seule la machine utilisant l'adresse IP indiquée dans votre zone DNS est autorisée à envoyer des courriels. \ No newline at end of file +```bash +DOMAIN.TLD 1800 TXT "v=spf1 a:DOMAIN.TLD ip4: ip6: mx ?all" + ``` + +Pour rappel, le champ SPF indique que seule la machine utilisant l'adresse IP indiquée dans votre zone DNS est autorisée à envoyer des courriels. +Si vous n'avez pas d'IPv6 sur votre serveur, supprimez simplement la section ip6:<…> \ No newline at end of file From 65c67c4cb6eebe37ebe1f25b2f3f006f71a067d3 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 28 Jun 2015 13:31:21 +0200 Subject: [PATCH 057/229] Update dkim.md --- dkim.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/dkim.md b/dkim.md index 7d7f4eb8..057752f1 100644 --- a/dkim.md +++ b/dkim.md @@ -154,7 +154,8 @@ To test if it is all working well (don't forget that the DNS propagation can tak # SPF Lastly, don't forget to add a SPF key in your [DNS zone](/dns_config_en) such as: ```bash -DOMAIN.TLD 300 TXT "v=spf1 a:DOMAIN.TLD mx ?all" -``` +DOMAIN.TLD 300 TXT "v=spf1 a:DOMAIN.TLD ip4: ip6: mx ?all" + ``` -As reminder, the SPF field shows that the only machine using the IP address shows in your DNS zone are authorized to send emails. \ No newline at end of file +As reminder, the SPF field shows that the only machine using the IP address shows in your DNS zone are authorized to send emails. +If you don't have IPv6 on your email server, simply delete le ip6:<...> section From e1d8c6bbb9aef8ac11b6d54d87fcba1b75f9108d Mon Sep 17 00:00:00 2001 From: niahoo osef Date: Fri, 3 Jul 2015 10:09:46 +0200 Subject: [PATCH 058/229] Petit changement syntaxique MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Je ne crois pas qu'on puisse dire « un usage de faire qqch » … du coup le mot « façon » convient bien. Sinon, on peut mettre « … une solutions bien plus […] **pour** faire de la mutualisation ». --- whatsyunohost_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/whatsyunohost_fr.md b/whatsyunohost_fr.md index 08143a66..b141c46f 100644 --- a/whatsyunohost_fr.md +++ b/whatsyunohost_fr.md @@ -87,6 +87,6 @@ Tous les efforts ont été déployés pour sécuriser YunoHost, et **chiffrer to Même si YunoHost est multi-domaine et multi-utilisateur, il reste **inapproprié pour un usage mutualisé**. -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 un usage bien plus étanche et sécurisé de faire de la mutualisation. +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 utilisateur, 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 (et nous vous fournissons le [panel de déploiement](https://github.com/YunoHost/Kremlin) !) From f9f770d8271097d5682d2cfe891ca55c077aff40 Mon Sep 17 00:00:00 2001 From: Voisin Date: Fri, 3 Jul 2015 19:17:28 +0200 Subject: [PATCH 059/229] Update apps_in_progress.md --- apps_in_progress.md | 1 + apps_wishlist.md | 3 +-- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/apps_in_progress.md b/apps_in_progress.md index 5af131ab..70b878ac 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -23,6 +23,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [243](https://hgentry.github.io/81/) | Moul |
| https://github.com/M5oul/243_ynh | Clone of 2048 game: goal reach 243 | | Ajax google apis | zamentur |
| https://github.com/zamentur/ajaxgoogleapis_ynh | Google APIs mirror | | [Ampache](http://ampache.org/) | beudbeud |
| https://github.com/abeudin/ampache_ynh | Web based audio/video streaming | +| [Adminer](http:/adminer.org/) | Fol |
| https://github.com/jesuisfol/adminer_ynh | Lightweight database administration tool | | [BTSync](http://www.getsync.com/) | tifred |
| https://github.com/drfred1981/btsync_ynh | File synchronization tool | | [Chtickynotes](https://github.com/chtixof/chtickynotes_ynh) | chtixof |
| https://github.com/chtixof/chtickynotes_ynh | A Post-it page | | [COPS](http://cops.com) | lunarok |
| https://github.com/lunarok/cops_ynh | Frontend for Calibre library | diff --git a/apps_wishlist.md b/apps_wishlist.md index a92645b8..d799d59c 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -7,7 +7,6 @@ The following list is a compiled wishlist of applications that would be nice-to- [Edit this list](/write_documentation) to add your own favorite app, or learn to [package apps](/packaging_apps) yourself. * [10er10](https://github.com/dready92/10er10) -* [adminer](http://www.adminer.org/) * [Ajenti](http://ajenti.org/) * [Autoblog](https://github.com/mitsukarenai/Projet-Autoblog) * [Bootstrap](http://getbootstrap.com/) @@ -89,4 +88,4 @@ The following list is a compiled wishlist of applications that would be nice-to- * [WebTorrent](https://github.com/feross/webtorrent) * [Wisemapping](http://www.wisemapping.com/) * [Zone-project](https://github.com/descl/ZONE) -* [ZNC](http://wiki.znc.in/ZNC) \ No newline at end of file +* [ZNC](http://wiki.znc.in/ZNC) From 0f46c827573c57603782392a94fec9f3f909a7df Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Sat, 4 Jul 2015 20:51:49 +0200 Subject: [PATCH 060/229] Update installation_brique_fr.md --- installation_brique_fr.md | 182 ++++++++++++++++++++++++++++++-------- 1 file changed, 146 insertions(+), 36 deletions(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index 335e014b..ad6c170d 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -1,60 +1,170 @@ # Introduction -Instructions d'installation de la brique écrite en temps réel lors de l'AG FFDN 2015, à compléter. +*Instructions basées sur l'image **[labriqueinternet_04-06-2015_jessie.img](http://repo.labriqueinter.net/labriqueinternet_04-06-2015_jessie.img.tar.xz)** et écrites début Juillet par kload chez **Neutrinet**.* -## Réservation VPN +## Prérequis -Cette étape est propre à chaque FAI. Récupérez les certificats et/ou mot de passe nécessaire à la connexion du client VPN, ainsi que les directives OpenVPN spécifiques si besoin. +Une **Brique Internet complète**, soit : +* Une board [A20-OLinuXino-LIME](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/open-source-hardware) +* Une carte microSD (on utilise des [Trasncend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO) pour des raisons de perf/stabilité) +* Une antenne WiFi [MOD-WIFI-R5370-ANT](https://www.olimex.com/Products/USB-Modules/MOD-WIFI-R5370-ANT/) (seule version testée jusqu’à présent chez nous) +* Un adaptateur secteur pour alimenter la brique ([chinois](https://www.olimex.com/Products/Power/SY0605E-CHINA/) ou [européen](https://www.olimex.com/Products/Power/SY0605E/)). L’alimentation via USB semble peu stable. +* Un câble Ethernet pour brancher la Brique à son routeur -Chez Neutrinet, nous avons par exemple besoin de la directive `topology subnet` (pour la compatibilité Windows \o/). +**+ un ordinateur sous UNIX** -## Télécharger l’image +--- -Sur http://repo.labriqueinter.net/ -( prendre la latest http://repo.labriqueinter.net/labriqueinternet_latest.img.tar.gz ) +L’installation s’articule en deux parties : les étapes réalisables sans avoir besoin de l’utilisateur, et les étapes de configuration pour lesquelles la présence de l’utilisateur est recommandée. -Faire un `dd` de l'image sur la carte SD a destination : +L’ordre des étapes est important :-) +## Étapes préliminaires + +1. Télécharger l’image à partir de https://repo.labriqueinter.net, valider son checksum. + +2. Copier l'image sur la carte à l'aide de `dd` (la commande, pas le patron du bistro d’en face) ```bash -sudo dd if=labriqueinternet_latest.img of=/dev/sdX +sudo dd if=labriqueinternet_XX-XX-XXXX_jessie.img of=/dev/sdX bs=1M ``` -Mettre la carte SD dans la boîte, puis la lancer et l'ayant branché sur le réseau locale avec un câble ethernet. +3. Mettre la carte SD dans une Brique, brancher le câble Ethernet et l’alimentation. Elle démarre normalement toute seule, et les LEDs du port Ethernet se mette à clignoter au bout de 10 secondes maximum. +
+Le premier démarrage peut mettre une grosse minute car la partition est redimensionnée et la board redémarrée automatiquement. +
-## Post-configuration - -Ensuite, aller sur `yunohost.local` ou l'ip en ssh et mettre à jours les pkgs. - -- user : root -- password : olinux +4. Récupérer l’adresse IP locale de la Brique, soit avec une commande comme `nmap -T4 -sP 192.168.x.0/24`, soit via l'interface du routeur listant les clients DHCP, soit en branchant un écran en HDMI à la Brique. +
+Admettons que l’adresse IP locale de la Brique soit **192.168.4.2** +
+5. Se connecter en SSH en root à la Brique, le mot de passe est **olinux** par défaut. Le changer par un mot de passe temporaire à modifier avec l’utilisateur par la suite. ```bash -apt-get update && apt-get dist-upgrade +ssh root@192.168.4.2 +``` +6. Mettre à jour le système (environ 10 minutes), et pré-installer les paquets qui seront nécessaires aux applications **vpnclient** et **hotspot** (comme ça c'est fait). +```bash +apt-get update && apt-get upgrade +apt-get install openvpn sipcalc hostapd iw dnsmasq firmware-linux-free firmware-linux-nonfree firmware-realtek firmware-ralink ``` -Puis y aller en http et accepter le certificat auto-signé, puis suivre les instructions de [postinstall](/postinstall). +--- -- choisir le nom de domaine -- choisir un mot de passe administrateur +**Plus d'étapes pourront sans doute être automatisées dans cette partie à l’avenir.** -Vous êtes redirigé sur l'interface d'admin et là, créer un nouvel utilisateur avec son mot de passe et co. +--- -## Installation des applications de la briqueinternet +## Étapes de configuration -Puis, installer les applications ("applications -> installer" et tout en bas mettre l'url vers le dépot GitHub) : - -- [HotSpot](https://github.com/labriqueinternet/hotspot_ynh) (https://github.com/labriqueinternet/hotspot_ynh) -- [VPNCient](https://github.com/labriqueinternet/vpnclient_ynh) (https://github.com/labriqueinternet/vpnclient_ynh) -- [TorClient](https://github.com/labriqueinternet/torclient_ynh) (https://github.com/labriqueinternet/torclient_ynh) -- [PirateBox](https://github.com/labriqueinternet/piratebox_ynh) (https://github.com/labriqueinternet/piratebox_ynh) - - -Ensuite, aller sur `http://monurl.com/vpnadmin` (ou ce que vous avez choisi). Là : - -(pour neutrinet) mettre `vpn.neutrinet.be` -copier/coller la conf généré pour le vpn dans l'endroit "advanced" -(pour l'instant pas configurer l'ipv6 pour neutrinet, le script doit être fini pour l'obtenir ou aller le chercher sur https://vpn.neutrinet.be:8000) +1. Assembler la Brique, la brancher sur le routeur, la démarrer, récupérer son IP locale et le nom de domaine désiré par l’utilisateur. +
+Ici nous installons la Brique de **michu.nohost.me** qui a pour IP locale **192.168.4.2** +
+2. Mettre à jour le fichier `/etc/hosts` de son ordinateur client pour pouvoir accéder à la Brique en local via **michu.nohost.me** (important pour la configuration des applications **vpnclient** et **hotspot**). +Ajouter à la fin du fichier : ```bash -scp auth client.crt client.key ca.crt dans /etc/openvpn/ +192.168.4.2 michu.nohost.me ``` + +3. Procéder à la [postinstallation](/postinstallation_fr) en se connectant à la Brique sur https://michu.nohost.me. L’uilisateur pourra lui-même saisir le mot de passe d’administration qu'il souhaite lors de cette étape. +
+**Note :** Il est possible de réaliser cette étape en ligne de commande via SSH en exécutant `yunohost tools postinstall` +
+ +4. Se connecter en SSH et changer le mot de passe *root* (potentiellement par le même mot de passe que l’administration pour éviter la complexité). +```bash +ssh root@michu.nohost.me +passwd root +``` + +5. **Fix temporaire** : La création des répertoires utilisateur ne se fait pas automatiquement dans cette image YunoHost pour la Brique. Il convient donc d'ajouter un script qui s'exécutera à la création des utilisateurs YunoHost et qui s’en assurera. +En SSH sur la Brique : +```bash +mkdir -p /usr/share/yunohost/hooks/post_user_create +cat > /usr/share/yunohost/hooks/post_user_create/06-create_userdir < **Nouvel utilisateur**. +
+Il faudra entrer un **nom d’utilisateur** sans majuscule/espace/tiret, un **nom/prénom/pseudo** en deux parties (obligatoires, merci LDAP) qui correspondra au nom qui apparaîtra sur les futurs emails de l’utilisateur, ainsi qu'un **quota d’email** éventuel et un **mot de passe** (*à ne pas confondre avec le mot de passe d’administration dans ce cas*). +
+ +7. **Installer l’application VPN Client** : Se rendre dans **Applications** > **Installer**, et entrer `https://github.com/labriqueinternet/vpnclient_ynh` dans le champs **URL** du formulaire **Installer une application personnalisée** tout en bas de la page. + +8. (optionnel) **Restreindre l`accès à l’application VPN Client** : Se rendre dans **Applications** > **VPN Client** > **Accès** et sélectionner l’utilisateur précédemment créé, de sorte que les futurs potentiels nouveaux utilisateurs ne pourront pas modifier les paramètres d’accès VPN. + +9. **Configurer l’application VPN Client** : Se connecter à l’**interface utilisateur** (ici https://michu.nohost.me/yunohost/sso/) et entrer les identifiants de l’utilisateur précédemment créé. Vous devriez voir apparaître **VPN Client** dans votre liste d’application : + +De manière générale, il convient bien sûr d’éditer les paramètres en fonction de son fournisseur d’accès VPN. +Chez Neutrinet, nous éditons, dans **Advanced**, le template de configuration pour y ajouter 3 directives spécifiques: +
resolv-retry infinite
+ns-cert-type server
+topology subnet
+
+**Attention** : le redémarrage du service, déclenché par le bouton **Save and reload**, peut mettre quelques minutes. +
+ +10. **Installer l’application Hotspot** : S'assurer que l’antenne WiFi est bien branchée, et répéter les étapes **7**, **8** et **9** en installant à l’aide de l'URL `https://github.com/labriqueinternet/hotspot_ynh` + + +11. **TESTEY** : La Brique devrait être accessible via l’IP publique que sa connexion VPN lui procure. Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, patientez quelques minutes que son IP se propage sur le serveur DNS de YunoHost. Si l’utilisateur a opté pour son propre nom de domaine, c’est le moment de [configurer ses enregistrements DNS](/dns_config_fr) correctement chez son registrar. +Si tout se passe bien côté **hotspot**, Un réseau WiFi du nom choisi par l’utilisateur à l’étape 10 devrait être visible, et devrait vous router tout bien vers l’Internet. Il est possible de regarder l’IP avec laquelle on sort sur Internet ici : http://ip.yunohost.org (ou `curl ip.yunohost.org` depuis le serveur) + +--- + +**Les problèmes proviennent majoritairement de la configuration VPN. Il convient de vérifier les paramètres côté client *et* serveur VPN en cas de pépin.** + +--- + +# Étapes supplémentaires (pour une Brique idéale) + +Ces étapes ne sont pas obligatoires mais peuvent améliorer considérablement l'**expérience de la Brique** (*fap fap fap*). + +* **Supprimer le CRON DynDNS** : Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, YunoHost a configuré automatiquement un client DynDNS sur la Brique qui va avertir le serveur DNS d’un potentiel changement d’IP publique. Or, l’IP fourni par la connexion VPN **est fixe**. Il convient donc de supprimer ce client, qui pourrait malencontreusement mettre à jour l’IP dans les DNS si la connexion VPN venait à tomber : +```bash +rm /etc/cron.d/yunohost-dyndns +``` + +* **S’assurer du nom de l’interface WiFi** : Lors du changement d’antenne WiFi (même si le modèle reste le même), il peut arriver que le nom de l’interface WiFi change, typiquement de `wlan0` à `wlan1`. Pour continuer à utiliser l’application **hotspot**, il faut se rendre sur l’interface web de configuration de l’application (étape 10) et mettre à jour le **Device**. + +* **Ajouter un CRON de restart du service VPN** : Selon vos paramètres VPN client et serveur, il peut arriver que la connexion soit instable, et que le client VPN tombe de temps en temps. Pour s’assurer qu’il redémarrera automatiquement, une bonne méthode *quick'n'dirty* et de tester que le service tourne et de le redémarrer dans le cas contraire : +```bash +echo "* * * * * /usr/bin/pgrep openvpn || systemctl restart ynh-vpnclient" > /etc/cron.d/restart-vpn +``` + +* **Ajouter un CRON de restart du service Amavisd** : Il peut arriver, notamment lorsque la Brique sature en RAM, que le service Amavisd s’arrête. Même *workaround* que pour le client VPN : +```bash +echo "0,30 * * * * /usr/bin/pgrep -u amavis amavi || systemctl restart amavis" > /etc/cron.d/restart-amavis +``` + +* **Mettre à jour la configuration SSH** : Par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_confg` et de remplacer passer **PermitRootLogin** à **without-password**. + +* **Configurer le reverse DNS** : Pour s’assurer du bon fonctionnement du serveur email, il est recommandé de configurer un reverse DNS pour son IP. En tant que FAI associatif, c’est un service faisable, autant en profiter ! + +* **Configurer le DKIM** : Avec un SPF et un PTR bien configuré dans les DNS, les emails envoyés par la Brique ne devrait pas être considérés comme spam. Ceci dit, GMail et d’autres dégraderont considérablement le spamscore si le DKIM n’est pas configuré également. +Cette opération est longue mais à considérer pour avoir un serveur email irréprochable en production. Plus de renseignement sur [la page de documentation appropriée](/dkim_fr). + +* **Installer Roundcube** via l’interface d’administration YunoHost et tester l’envoi/réception d’email. + +* **Installer d’autres applications** et les découvrir avec l’utilisateur pour l'accompagner (c'est toujours sympa \o/). + +--- + +## Notes + +* **Attention à la RAM** : Sur le modèle A20-OLinuXino-LIME, les **512 Mo** partent vite. Les applications PHP ne sont pas très gourmandes, mais Searx et Etherpad Lite sont par exemple à installer avec des pincettes. + +* **Glances ne fonctionne pas** sur l’image *labriqueinternet_04-06-2015_jessie.img*, ce qui rend l’onglet **État du serveur** inaccessible dans l’interface d’adminstration de YunoHost. Une mise à jour future du noyau sera à prévoir pour corriger le problème. + +* Attention à bien veiller à ce que les répertoires utilisateurs soient bien créés (étape 5.) dans `/var/mail` et `/home/`, sans quoi plusieurs bugs seront observables dans l’interface d’administration (erreurs 500 en pagaille). \ No newline at end of file From 75ec2ff042bfbcba86b4b2987f1c9c32788f2508 Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Sat, 4 Jul 2015 20:57:00 +0200 Subject: [PATCH 061/229] Update installation_brique_fr.md --- installation_brique_fr.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index ad6c170d..b9696b12 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -118,8 +118,9 @@ topology subnet
-11. **TESTEY** : La Brique devrait être accessible via l’IP publique que sa connexion VPN lui procure. Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, patientez quelques minutes que son IP se propage sur le serveur DNS de YunoHost. Si l’utilisateur a opté pour son propre nom de domaine, c’est le moment de [configurer ses enregistrements DNS](/dns_config_fr) correctement chez son registrar. -Si tout se passe bien côté **hotspot**, Un réseau WiFi du nom choisi par l’utilisateur à l’étape 10 devrait être visible, et devrait vous router tout bien vers l’Internet. Il est possible de regarder l’IP avec laquelle on sort sur Internet ici : http://ip.yunohost.org (ou `curl ip.yunohost.org` depuis le serveur) +11. **TESTEY** : La Brique devrait être accessible via l’IP publique que sa connexion VPN lui procure. Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, patienter quelques minutes que son IP se propage sur le serveur DNS de YunoHost. Si l’utilisateur a opté pour son propre nom de domaine, c’est le moment de [configurer ses enregistrements DNS](/dns_config_fr) correctement chez son registrar. +Si tout se passe bien côté **hotspot**, un réseau WiFi du nom choisi par l’utilisateur à l’étape 10 devrait être visible, et devrait vous router tout bien vers l’Internet. +Il est possible de regarder l’IP avec laquelle on sort sur Internet [ici](http://ip.yunohost.org) (ou via `curl ip.yunohost.org` depuis le serveur) --- From 6f64c2e8fba498b729cda454e11408866aa68d0f Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Sat, 4 Jul 2015 21:00:22 +0200 Subject: [PATCH 062/229] Update installation_brique_fr.md --- installation_brique_fr.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index b9696b12..317e0e60 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -1,7 +1,9 @@ -# Introduction +# Installation d'une Brique Internet *Instructions basées sur l'image **[labriqueinternet_04-06-2015_jessie.img](http://repo.labriqueinter.net/labriqueinternet_04-06-2015_jessie.img.tar.xz)** et écrites début Juillet par kload chez **Neutrinet**.* +![brique](https://yunohost.org/images/thisisinternet.png) + ## Prérequis Une **Brique Internet complète**, soit : From 04de9e95bbac7effe78c80af688546aca9c13820 Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Sat, 4 Jul 2015 21:00:42 +0200 Subject: [PATCH 063/229] Update install_fr.md --- install_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/install_fr.md b/install_fr.md index 7cfcf1aa..7df91060 100644 --- a/install_fr.md +++ b/install_fr.md @@ -30,7 +30,7 @@ Cette page liste plusieurs types d'installations, classés par catégories.
-

Sur la Brique Internet

 +

Sur la Brique Internet
From 4e27b726f84445cd131f613dea09a6624857fdcb Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Sat, 4 Jul 2015 21:01:01 +0200 Subject: [PATCH 064/229] Update install.md --- install.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/install.md b/install.md index 2ed492c0..bc116b0a 100644 --- a/install.md +++ b/install.md @@ -29,10 +29,6 @@ This page lists few installation guides.
-
-

On the Internet brick

 -
-

On a Raspberry Pi
From b171eb7d180abedec1a45e461a46b3128dd7a16d Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Sat, 4 Jul 2015 21:09:32 +0200 Subject: [PATCH 065/229] Update installation_brique_fr.md --- installation_brique_fr.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index 317e0e60..f994683d 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -30,7 +30,7 @@ L’ordre des étapes est important :-) sudo dd if=labriqueinternet_XX-XX-XXXX_jessie.img of=/dev/sdX bs=1M ``` -3. Mettre la carte SD dans une Brique, brancher le câble Ethernet et l’alimentation. Elle démarre normalement toute seule, et les LEDs du port Ethernet se mette à clignoter au bout de 10 secondes maximum. +3. Mettre la carte SD dans une Brique, brancher le câble Ethernet et l’alimentation. Elle démarre normalement toute seule, et les LEDs du port Ethernet se mettent à clignoter au bout de 10 secondes maximum.
Le premier démarrage peut mettre une grosse minute car la partition est redimensionnée et la board redémarrée automatiquement.
@@ -74,7 +74,7 @@ Ajouter à la fin du fichier : **Note :** Il est possible de réaliser cette étape en ligne de commande via SSH en exécutant `yunohost tools postinstall`
-4. Se connecter en SSH et changer le mot de passe *root* (potentiellement par le même mot de passe que l’administration pour éviter la complexité). +4. Se connecter en SSH et changer le mot de passe **root** (potentiellement par le même mot de passe que l’administration pour éviter la complexité). ```bash ssh root@michu.nohost.me passwd root @@ -100,9 +100,9 @@ Il faudra entrer un **nom d’utilisateur** sans majuscule/espace/tiret, un **no 7. **Installer l’application VPN Client** : Se rendre dans **Applications** > **Installer**, et entrer `https://github.com/labriqueinternet/vpnclient_ynh` dans le champs **URL** du formulaire **Installer une application personnalisée** tout en bas de la page. -8. (optionnel) **Restreindre l`accès à l’application VPN Client** : Se rendre dans **Applications** > **VPN Client** > **Accès** et sélectionner l’utilisateur précédemment créé, de sorte que les futurs potentiels nouveaux utilisateurs ne pourront pas modifier les paramètres d’accès VPN. +8. (optionnel) **Restreindre l`accès à l’application VPN Client** : Se rendre dans **Applications** > **VPN Client** > **Accès** et sélectionner l’utilisateur précédemment créé, de sorte que les futurs potentiels nouveaux utilisateurs ne puissent pas modifier les paramètres d’accès VPN. -9. **Configurer l’application VPN Client** : Se connecter à l’**interface utilisateur** (ici https://michu.nohost.me/yunohost/sso/) et entrer les identifiants de l’utilisateur précédemment créé. Vous devriez voir apparaître **VPN Client** dans votre liste d’application : +9. **Configurer l’application VPN Client** : Se connecter à l’**interface utilisateur** (ici https://michu.nohost.me/yunohost/sso/) et entrer les identifiants de l’utilisateur précédemment créé. L’application **VPN Client** devrait apparaître dans la liste d’application : @@ -141,7 +141,7 @@ rm /etc/cron.d/yunohost-dyndns * **S’assurer du nom de l’interface WiFi** : Lors du changement d’antenne WiFi (même si le modèle reste le même), il peut arriver que le nom de l’interface WiFi change, typiquement de `wlan0` à `wlan1`. Pour continuer à utiliser l’application **hotspot**, il faut se rendre sur l’interface web de configuration de l’application (étape 10) et mettre à jour le **Device**. -* **Ajouter un CRON de restart du service VPN** : Selon vos paramètres VPN client et serveur, il peut arriver que la connexion soit instable, et que le client VPN tombe de temps en temps. Pour s’assurer qu’il redémarrera automatiquement, une bonne méthode *quick'n'dirty* et de tester que le service tourne et de le redémarrer dans le cas contraire : +* **Ajouter un CRON de restart du service VPN** : Selon les paramètres VPN client et serveur, il peut arriver que la connexion soit instable, et que le client VPN tombe de temps en temps. Pour s’assurer qu’il redémarrera automatiquement, une bonne méthode *quick'n'dirty* et de tester que le service tourne et de le redémarrer dans le cas contraire : ```bash echo "* * * * * /usr/bin/pgrep openvpn || systemctl restart ynh-vpnclient" > /etc/cron.d/restart-vpn ``` From 20604df2e61be87ecc0e5d712ab04f1540c6b6ee Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 4 Jul 2015 21:21:17 +0200 Subject: [PATCH 066/229] Update installation_brique_fr.md --- installation_brique_fr.md | 44 +++++++++++++++++++-------------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index f994683d..fb29545e 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -1,4 +1,4 @@ -# Installation d'une Brique Internet +# Installation d’une Brique Internet *Instructions basées sur l'image **[labriqueinternet_04-06-2015_jessie.img](http://repo.labriqueinter.net/labriqueinternet_04-06-2015_jessie.img.tar.xz)** et écrites début Juillet par kload chez **Neutrinet**.* @@ -8,10 +8,10 @@ Une **Brique Internet complète**, soit : * Une board [A20-OLinuXino-LIME](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/open-source-hardware) -* Une carte microSD (on utilise des [Trasncend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO) pour des raisons de perf/stabilité) +* Une carte microSD (on utilise des [Trasncend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO) pour des raisons de performance/stabilité) * Une antenne WiFi [MOD-WIFI-R5370-ANT](https://www.olimex.com/Products/USB-Modules/MOD-WIFI-R5370-ANT/) (seule version testée jusqu’à présent chez nous) * Un adaptateur secteur pour alimenter la brique ([chinois](https://www.olimex.com/Products/Power/SY0605E-CHINA/) ou [européen](https://www.olimex.com/Products/Power/SY0605E/)). L’alimentation via USB semble peu stable. -* Un câble Ethernet pour brancher la Brique à son routeur +* Un câble Ethernet/RJ-45 pour brancher la Brique à son routeur **+ un ordinateur sous UNIX** @@ -47,12 +47,12 @@ ssh root@192.168.4.2 6. Mettre à jour le système (environ 10 minutes), et pré-installer les paquets qui seront nécessaires aux applications **vpnclient** et **hotspot** (comme ça c'est fait). ```bash apt-get update && apt-get upgrade -apt-get install openvpn sipcalc hostapd iw dnsmasq firmware-linux-free firmware-linux-nonfree firmware-realtek firmware-ralink +apt-get install openvpn sipcalc hostapd iw dnsmasq firmware-linux-free firmware-linux-nonfree \ firmware-realtek firmware-ralink ``` --- -**Plus d'étapes pourront sans doute être automatisées dans cette partie à l’avenir.** +**Plus d’étapes pourront sans doute être automatisées dans cette partie à l’avenir.** --- @@ -71,7 +71,7 @@ Ajouter à la fin du fichier : 3. Procéder à la [postinstallation](/postinstallation_fr) en se connectant à la Brique sur https://michu.nohost.me. L’uilisateur pourra lui-même saisir le mot de passe d’administration qu'il souhaite lors de cette étape.
-**Note :** Il est possible de réaliser cette étape en ligne de commande via SSH en exécutant `yunohost tools postinstall` +**Note :** il est possible de réaliser cette étape en ligne de commande via SSH en exécutant `yunohost tools postinstall`
4. Se connecter en SSH et changer le mot de passe **root** (potentiellement par le même mot de passe que l’administration pour éviter la complexité). @@ -80,7 +80,7 @@ ssh root@michu.nohost.me passwd root ``` -5. **Fix temporaire** : La création des répertoires utilisateur ne se fait pas automatiquement dans cette image YunoHost pour la Brique. Il convient donc d'ajouter un script qui s'exécutera à la création des utilisateurs YunoHost et qui s’en assurera. +5. **Fix temporaire** : la création des répertoires utilisateur ne se fait pas automatiquement dans cette image YunoHost pour la Brique. Il convient donc d'ajouter un script qui s'exécutera à la création des utilisateurs YunoHost et qui s’en assurera. En SSH sur la Brique : ```bash mkdir -p /usr/share/yunohost/hooks/post_user_create @@ -93,21 +93,21 @@ mkhomedir_helper \$user EOF ``` -6. **Créer le premier utilisateur** : Se rendre dans l’interface d’administration YunoHost (ici https://michu.nohost.me/yunohost/admin), entrer le mot de passe d’administration puis se rendre dans **Utilisateurs** > **Nouvel utilisateur**. +6. **Créer le premier utilisateur** : se rendre dans l’interface d’administration YunoHost (ici https://michu.nohost.me/yunohost/admin), entrer le mot de passe d’administration puis se rendre dans **Utilisateurs** > **Nouvel utilisateur**.
Il faudra entrer un **nom d’utilisateur** sans majuscule/espace/tiret, un **nom/prénom/pseudo** en deux parties (obligatoires, merci LDAP) qui correspondra au nom qui apparaîtra sur les futurs emails de l’utilisateur, ainsi qu'un **quota d’email** éventuel et un **mot de passe** (*à ne pas confondre avec le mot de passe d’administration dans ce cas*).
-7. **Installer l’application VPN Client** : Se rendre dans **Applications** > **Installer**, et entrer `https://github.com/labriqueinternet/vpnclient_ynh` dans le champs **URL** du formulaire **Installer une application personnalisée** tout en bas de la page. +7. **Installer l’application VPN Client** : se rendre dans **Applications** > **Installer**, et entrer `https://github.com/labriqueinternet/vpnclient_ynh` dans le champs **URL** du formulaire **Installer une application personnalisée** tout en bas de la page. -8. (optionnel) **Restreindre l`accès à l’application VPN Client** : Se rendre dans **Applications** > **VPN Client** > **Accès** et sélectionner l’utilisateur précédemment créé, de sorte que les futurs potentiels nouveaux utilisateurs ne puissent pas modifier les paramètres d’accès VPN. +8. (optionnel) **Restreindre l’accès à l’application VPN Client** : se connecter à l’**interface utilisateur** (ici https://michu.nohost.me/yunohost/sso/) et entrer les identifiants de l’utilisateur précédemment créé. L’application **VPN Client** devrait apparaître dans la liste d’application : -9. **Configurer l’application VPN Client** : Se connecter à l’**interface utilisateur** (ici https://michu.nohost.me/yunohost/sso/) et entrer les identifiants de l’utilisateur précédemment créé. L’application **VPN Client** devrait apparaître dans la liste d’application : +9. **Configurer l’application VPN Client** : se connecter à l’**interface utilisateur** (ici https://michu.nohost.me/yunohost/sso/) et entrer les identifiants de l’utilisateur précédemment créé. Vous devriez voir apparaître **VPN Client** dans votre liste d’application : De manière générale, il convient bien sûr d’éditer les paramètres en fonction de son fournisseur d’accès VPN. -Chez Neutrinet, nous éditons, dans **Advanced**, le template de configuration pour y ajouter 3 directives spécifiques: +Chez Neutrinet, nous éditons, dans **Advanced**, le template de configuration pour y ajouter trois directives spécifiques : 
resolv-retry infinite
 ns-cert-type server
 topology subnet
@@ -115,12 +115,12 @@ topology subnet **Attention** : le redémarrage du service, déclenché par le bouton **Save and reload**, peut mettre quelques minutes.
-10. **Installer l’application Hotspot** : S'assurer que l’antenne WiFi est bien branchée, et répéter les étapes **7**, **8** et **9** en installant à l’aide de l'URL `https://github.com/labriqueinternet/hotspot_ynh` +10. **Installer l’application Hotspot** : s'assurer que l’antenne WiFi est bien branchée, et répéter les étapes **7**, **8** et **9** en installant à l’aide de l'URL `https://github.com/labriqueinternet/hotspot_ynh` -11. **TESTEY** : La Brique devrait être accessible via l’IP publique que sa connexion VPN lui procure. Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, patienter quelques minutes que son IP se propage sur le serveur DNS de YunoHost. Si l’utilisateur a opté pour son propre nom de domaine, c’est le moment de [configurer ses enregistrements DNS](/dns_config_fr) correctement chez son registrar. +11. **TESTEY** : la Brique devrait être accessible via l’IP publique que sa connexion VPN lui procure. Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, patienter quelques minutes que son IP se propage sur le serveur DNS de YunoHost. Si l’utilisateur a opté pour son propre nom de domaine, c’est le moment de [configurer ses enregistrements DNS](/dns_config_fr) correctement chez son registrar. Si tout se passe bien côté **hotspot**, un réseau WiFi du nom choisi par l’utilisateur à l’étape 10 devrait être visible, et devrait vous router tout bien vers l’Internet. Il est possible de regarder l’IP avec laquelle on sort sur Internet [ici](http://ip.yunohost.org) (ou via `curl ip.yunohost.org` depuis le serveur) @@ -134,28 +134,28 @@ Il est possible de regarder l’IP avec laquelle on sort sur Internet [ici](http Ces étapes ne sont pas obligatoires mais peuvent améliorer considérablement l'**expérience de la Brique** (*fap fap fap*). -* **Supprimer le CRON DynDNS** : Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, YunoHost a configuré automatiquement un client DynDNS sur la Brique qui va avertir le serveur DNS d’un potentiel changement d’IP publique. Or, l’IP fourni par la connexion VPN **est fixe**. Il convient donc de supprimer ce client, qui pourrait malencontreusement mettre à jour l’IP dans les DNS si la connexion VPN venait à tomber : +* **Supprimer le CRON DynDNS** : si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, YunoHost a configuré automatiquement un client DynDNS sur la Brique qui va avertir le serveur DNS d’un potentiel changement d’IP publique. Or, l’IP fourni par la connexion VPN **est fixe**. Il convient donc de supprimer ce client, qui pourrait malencontreusement mettre à jour l’IP dans les DNS si la connexion VPN venait à tomber : ```bash rm /etc/cron.d/yunohost-dyndns ``` -* **S’assurer du nom de l’interface WiFi** : Lors du changement d’antenne WiFi (même si le modèle reste le même), il peut arriver que le nom de l’interface WiFi change, typiquement de `wlan0` à `wlan1`. Pour continuer à utiliser l’application **hotspot**, il faut se rendre sur l’interface web de configuration de l’application (étape 10) et mettre à jour le **Device**. +* **S’assurer du nom de l’interface WiFi** : lors du changement d’antenne WiFi (même si le modèle reste le même), il peut arriver que le nom de l’interface WiFi change, typiquement de `wlan0` à `wlan1`. Pour continuer à utiliser l’application **hotspot**, il faut se rendre sur l’interface web de configuration de l’application (étape 10) et mettre à jour le **Device**. -* **Ajouter un CRON de restart du service VPN** : Selon les paramètres VPN client et serveur, il peut arriver que la connexion soit instable, et que le client VPN tombe de temps en temps. Pour s’assurer qu’il redémarrera automatiquement, une bonne méthode *quick'n'dirty* et de tester que le service tourne et de le redémarrer dans le cas contraire : +* **Ajouter un CRON de restart du service VPN** : selon les paramètres VPN client et serveur, il peut arriver que la connexion soit instable, et que le client VPN tombe de temps en temps. Pour s’assurer qu’il redémarrera automatiquement, une bonne méthode *quick'n'dirty* et de tester que le service tourne et de le redémarrer dans le cas contraire : ```bash echo "* * * * * /usr/bin/pgrep openvpn || systemctl restart ynh-vpnclient" > /etc/cron.d/restart-vpn ``` -* **Ajouter un CRON de restart du service Amavisd** : Il peut arriver, notamment lorsque la Brique sature en RAM, que le service Amavisd s’arrête. Même *workaround* que pour le client VPN : +* **Ajouter un CRON de restart du service Amavisd** : il peut arriver, notamment lorsque la Brique sature en RAM, que le service Amavisd s’arrête. Même *workaround* que pour le client VPN : ```bash echo "0,30 * * * * /usr/bin/pgrep -u amavis amavi || systemctl restart amavis" > /etc/cron.d/restart-amavis ``` -* **Mettre à jour la configuration SSH** : Par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_confg` et de remplacer passer **PermitRootLogin** à **without-password**. +* **Mettre à jour la configuration SSH** : par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_confg` et de remplacer passer **PermitRootLogin** à **without-password**. -* **Configurer le reverse DNS** : Pour s’assurer du bon fonctionnement du serveur email, il est recommandé de configurer un reverse DNS pour son IP. En tant que FAI associatif, c’est un service faisable, autant en profiter ! +* **Configurer le reverse DNS** : pour s’assurer du bon fonctionnement du serveur email, il est recommandé de configurer un reverse DNS pour son IP. En tant que FAI associatif, c’est un service faisable, autant en profiter ! -* **Configurer le DKIM** : Avec un SPF et un PTR bien configuré dans les DNS, les emails envoyés par la Brique ne devrait pas être considérés comme spam. Ceci dit, GMail et d’autres dégraderont considérablement le spamscore si le DKIM n’est pas configuré également. +* **Configurer le DKIM** : avec un SPF et un PTR bien configuré dans les DNS, les emails envoyés par la Brique ne devrait pas être considérés comme spam. Ceci dit, GMail et d’autres dégraderont considérablement le spamscore si le DKIM n’est pas configuré également. Cette opération est longue mais à considérer pour avoir un serveur email irréprochable en production. Plus de renseignement sur [la page de documentation appropriée](/dkim_fr). * **Installer Roundcube** via l’interface d’administration YunoHost et tester l’envoi/réception d’email. @@ -166,7 +166,7 @@ Cette opération est longue mais à considérer pour avoir un serveur email irr ## Notes -* **Attention à la RAM** : Sur le modèle A20-OLinuXino-LIME, les **512 Mo** partent vite. Les applications PHP ne sont pas très gourmandes, mais Searx et Etherpad Lite sont par exemple à installer avec des pincettes. +* **Attention à la RAM** : sur le modèle A20-OLinuXino-LIME, les **512 Mo** partent vite. Les applications PHP ne sont pas très gourmandes, mais Searx et Etherpad Lite sont par exemple à installer avec des pincettes. * **Glances ne fonctionne pas** sur l’image *labriqueinternet_04-06-2015_jessie.img*, ce qui rend l’onglet **État du serveur** inaccessible dans l’interface d’adminstration de YunoHost. Une mise à jour future du noyau sera à prévoir pour corriger le problème. From e3fb0080d2be0ed34d560a09a7788b7dce9f2b04 Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Sat, 4 Jul 2015 21:23:13 +0200 Subject: [PATCH 067/229] Update installation_brique_fr.md --- installation_brique_fr.md | 44 +++++++++++++++++++-------------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index fb29545e..f994683d 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -1,4 +1,4 @@ -# Installation d’une Brique Internet +# Installation d'une Brique Internet *Instructions basées sur l'image **[labriqueinternet_04-06-2015_jessie.img](http://repo.labriqueinter.net/labriqueinternet_04-06-2015_jessie.img.tar.xz)** et écrites début Juillet par kload chez **Neutrinet**.* @@ -8,10 +8,10 @@ Une **Brique Internet complète**, soit : * Une board [A20-OLinuXino-LIME](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/open-source-hardware) -* Une carte microSD (on utilise des [Trasncend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO) pour des raisons de performance/stabilité) +* Une carte microSD (on utilise des [Trasncend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO) pour des raisons de perf/stabilité) * Une antenne WiFi [MOD-WIFI-R5370-ANT](https://www.olimex.com/Products/USB-Modules/MOD-WIFI-R5370-ANT/) (seule version testée jusqu’à présent chez nous) * Un adaptateur secteur pour alimenter la brique ([chinois](https://www.olimex.com/Products/Power/SY0605E-CHINA/) ou [européen](https://www.olimex.com/Products/Power/SY0605E/)). L’alimentation via USB semble peu stable. -* Un câble Ethernet/RJ-45 pour brancher la Brique à son routeur +* Un câble Ethernet pour brancher la Brique à son routeur **+ un ordinateur sous UNIX** @@ -47,12 +47,12 @@ ssh root@192.168.4.2 6. Mettre à jour le système (environ 10 minutes), et pré-installer les paquets qui seront nécessaires aux applications **vpnclient** et **hotspot** (comme ça c'est fait). ```bash apt-get update && apt-get upgrade -apt-get install openvpn sipcalc hostapd iw dnsmasq firmware-linux-free firmware-linux-nonfree \ firmware-realtek firmware-ralink +apt-get install openvpn sipcalc hostapd iw dnsmasq firmware-linux-free firmware-linux-nonfree firmware-realtek firmware-ralink ``` --- -**Plus d’étapes pourront sans doute être automatisées dans cette partie à l’avenir.** +**Plus d'étapes pourront sans doute être automatisées dans cette partie à l’avenir.** --- @@ -71,7 +71,7 @@ Ajouter à la fin du fichier : 3. Procéder à la [postinstallation](/postinstallation_fr) en se connectant à la Brique sur https://michu.nohost.me. L’uilisateur pourra lui-même saisir le mot de passe d’administration qu'il souhaite lors de cette étape.
-**Note :** il est possible de réaliser cette étape en ligne de commande via SSH en exécutant `yunohost tools postinstall` +**Note :** Il est possible de réaliser cette étape en ligne de commande via SSH en exécutant `yunohost tools postinstall`
4. Se connecter en SSH et changer le mot de passe **root** (potentiellement par le même mot de passe que l’administration pour éviter la complexité). @@ -80,7 +80,7 @@ ssh root@michu.nohost.me passwd root ``` -5. **Fix temporaire** : la création des répertoires utilisateur ne se fait pas automatiquement dans cette image YunoHost pour la Brique. Il convient donc d'ajouter un script qui s'exécutera à la création des utilisateurs YunoHost et qui s’en assurera. +5. **Fix temporaire** : La création des répertoires utilisateur ne se fait pas automatiquement dans cette image YunoHost pour la Brique. Il convient donc d'ajouter un script qui s'exécutera à la création des utilisateurs YunoHost et qui s’en assurera. En SSH sur la Brique : ```bash mkdir -p /usr/share/yunohost/hooks/post_user_create @@ -93,21 +93,21 @@ mkhomedir_helper \$user EOF ``` -6. **Créer le premier utilisateur** : se rendre dans l’interface d’administration YunoHost (ici https://michu.nohost.me/yunohost/admin), entrer le mot de passe d’administration puis se rendre dans **Utilisateurs** > **Nouvel utilisateur**. +6. **Créer le premier utilisateur** : Se rendre dans l’interface d’administration YunoHost (ici https://michu.nohost.me/yunohost/admin), entrer le mot de passe d’administration puis se rendre dans **Utilisateurs** > **Nouvel utilisateur**.
Il faudra entrer un **nom d’utilisateur** sans majuscule/espace/tiret, un **nom/prénom/pseudo** en deux parties (obligatoires, merci LDAP) qui correspondra au nom qui apparaîtra sur les futurs emails de l’utilisateur, ainsi qu'un **quota d’email** éventuel et un **mot de passe** (*à ne pas confondre avec le mot de passe d’administration dans ce cas*).
-7. **Installer l’application VPN Client** : se rendre dans **Applications** > **Installer**, et entrer `https://github.com/labriqueinternet/vpnclient_ynh` dans le champs **URL** du formulaire **Installer une application personnalisée** tout en bas de la page. +7. **Installer l’application VPN Client** : Se rendre dans **Applications** > **Installer**, et entrer `https://github.com/labriqueinternet/vpnclient_ynh` dans le champs **URL** du formulaire **Installer une application personnalisée** tout en bas de la page. -8. (optionnel) **Restreindre l’accès à l’application VPN Client** : se connecter à l’**interface utilisateur** (ici https://michu.nohost.me/yunohost/sso/) et entrer les identifiants de l’utilisateur précédemment créé. L’application **VPN Client** devrait apparaître dans la liste d’application : +8. (optionnel) **Restreindre l`accès à l’application VPN Client** : Se rendre dans **Applications** > **VPN Client** > **Accès** et sélectionner l’utilisateur précédemment créé, de sorte que les futurs potentiels nouveaux utilisateurs ne puissent pas modifier les paramètres d’accès VPN. -9. **Configurer l’application VPN Client** : se connecter à l’**interface utilisateur** (ici https://michu.nohost.me/yunohost/sso/) et entrer les identifiants de l’utilisateur précédemment créé. Vous devriez voir apparaître **VPN Client** dans votre liste d’application : +9. **Configurer l’application VPN Client** : Se connecter à l’**interface utilisateur** (ici https://michu.nohost.me/yunohost/sso/) et entrer les identifiants de l’utilisateur précédemment créé. L’application **VPN Client** devrait apparaître dans la liste d’application : De manière générale, il convient bien sûr d’éditer les paramètres en fonction de son fournisseur d’accès VPN. -Chez Neutrinet, nous éditons, dans **Advanced**, le template de configuration pour y ajouter trois directives spécifiques : +Chez Neutrinet, nous éditons, dans **Advanced**, le template de configuration pour y ajouter 3 directives spécifiques: 
resolv-retry infinite
 ns-cert-type server
 topology subnet
@@ -115,12 +115,12 @@ topology subnet **Attention** : le redémarrage du service, déclenché par le bouton **Save and reload**, peut mettre quelques minutes.
-10. **Installer l’application Hotspot** : s'assurer que l’antenne WiFi est bien branchée, et répéter les étapes **7**, **8** et **9** en installant à l’aide de l'URL `https://github.com/labriqueinternet/hotspot_ynh` +10. **Installer l’application Hotspot** : S'assurer que l’antenne WiFi est bien branchée, et répéter les étapes **7**, **8** et **9** en installant à l’aide de l'URL `https://github.com/labriqueinternet/hotspot_ynh` -11. **TESTEY** : la Brique devrait être accessible via l’IP publique que sa connexion VPN lui procure. Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, patienter quelques minutes que son IP se propage sur le serveur DNS de YunoHost. Si l’utilisateur a opté pour son propre nom de domaine, c’est le moment de [configurer ses enregistrements DNS](/dns_config_fr) correctement chez son registrar. +11. **TESTEY** : La Brique devrait être accessible via l’IP publique que sa connexion VPN lui procure. Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, patienter quelques minutes que son IP se propage sur le serveur DNS de YunoHost. Si l’utilisateur a opté pour son propre nom de domaine, c’est le moment de [configurer ses enregistrements DNS](/dns_config_fr) correctement chez son registrar. Si tout se passe bien côté **hotspot**, un réseau WiFi du nom choisi par l’utilisateur à l’étape 10 devrait être visible, et devrait vous router tout bien vers l’Internet. Il est possible de regarder l’IP avec laquelle on sort sur Internet [ici](http://ip.yunohost.org) (ou via `curl ip.yunohost.org` depuis le serveur) @@ -134,28 +134,28 @@ Il est possible de regarder l’IP avec laquelle on sort sur Internet [ici](http Ces étapes ne sont pas obligatoires mais peuvent améliorer considérablement l'**expérience de la Brique** (*fap fap fap*). -* **Supprimer le CRON DynDNS** : si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, YunoHost a configuré automatiquement un client DynDNS sur la Brique qui va avertir le serveur DNS d’un potentiel changement d’IP publique. Or, l’IP fourni par la connexion VPN **est fixe**. Il convient donc de supprimer ce client, qui pourrait malencontreusement mettre à jour l’IP dans les DNS si la connexion VPN venait à tomber : +* **Supprimer le CRON DynDNS** : Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, YunoHost a configuré automatiquement un client DynDNS sur la Brique qui va avertir le serveur DNS d’un potentiel changement d’IP publique. Or, l’IP fourni par la connexion VPN **est fixe**. Il convient donc de supprimer ce client, qui pourrait malencontreusement mettre à jour l’IP dans les DNS si la connexion VPN venait à tomber : ```bash rm /etc/cron.d/yunohost-dyndns ``` -* **S’assurer du nom de l’interface WiFi** : lors du changement d’antenne WiFi (même si le modèle reste le même), il peut arriver que le nom de l’interface WiFi change, typiquement de `wlan0` à `wlan1`. Pour continuer à utiliser l’application **hotspot**, il faut se rendre sur l’interface web de configuration de l’application (étape 10) et mettre à jour le **Device**. +* **S’assurer du nom de l’interface WiFi** : Lors du changement d’antenne WiFi (même si le modèle reste le même), il peut arriver que le nom de l’interface WiFi change, typiquement de `wlan0` à `wlan1`. Pour continuer à utiliser l’application **hotspot**, il faut se rendre sur l’interface web de configuration de l’application (étape 10) et mettre à jour le **Device**. -* **Ajouter un CRON de restart du service VPN** : selon les paramètres VPN client et serveur, il peut arriver que la connexion soit instable, et que le client VPN tombe de temps en temps. Pour s’assurer qu’il redémarrera automatiquement, une bonne méthode *quick'n'dirty* et de tester que le service tourne et de le redémarrer dans le cas contraire : +* **Ajouter un CRON de restart du service VPN** : Selon les paramètres VPN client et serveur, il peut arriver que la connexion soit instable, et que le client VPN tombe de temps en temps. Pour s’assurer qu’il redémarrera automatiquement, une bonne méthode *quick'n'dirty* et de tester que le service tourne et de le redémarrer dans le cas contraire : ```bash echo "* * * * * /usr/bin/pgrep openvpn || systemctl restart ynh-vpnclient" > /etc/cron.d/restart-vpn ``` -* **Ajouter un CRON de restart du service Amavisd** : il peut arriver, notamment lorsque la Brique sature en RAM, que le service Amavisd s’arrête. Même *workaround* que pour le client VPN : +* **Ajouter un CRON de restart du service Amavisd** : Il peut arriver, notamment lorsque la Brique sature en RAM, que le service Amavisd s’arrête. Même *workaround* que pour le client VPN : ```bash echo "0,30 * * * * /usr/bin/pgrep -u amavis amavi || systemctl restart amavis" > /etc/cron.d/restart-amavis ``` -* **Mettre à jour la configuration SSH** : par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_confg` et de remplacer passer **PermitRootLogin** à **without-password**. +* **Mettre à jour la configuration SSH** : Par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_confg` et de remplacer passer **PermitRootLogin** à **without-password**. -* **Configurer le reverse DNS** : pour s’assurer du bon fonctionnement du serveur email, il est recommandé de configurer un reverse DNS pour son IP. En tant que FAI associatif, c’est un service faisable, autant en profiter ! +* **Configurer le reverse DNS** : Pour s’assurer du bon fonctionnement du serveur email, il est recommandé de configurer un reverse DNS pour son IP. En tant que FAI associatif, c’est un service faisable, autant en profiter ! -* **Configurer le DKIM** : avec un SPF et un PTR bien configuré dans les DNS, les emails envoyés par la Brique ne devrait pas être considérés comme spam. Ceci dit, GMail et d’autres dégraderont considérablement le spamscore si le DKIM n’est pas configuré également. +* **Configurer le DKIM** : Avec un SPF et un PTR bien configuré dans les DNS, les emails envoyés par la Brique ne devrait pas être considérés comme spam. Ceci dit, GMail et d’autres dégraderont considérablement le spamscore si le DKIM n’est pas configuré également. Cette opération est longue mais à considérer pour avoir un serveur email irréprochable en production. Plus de renseignement sur [la page de documentation appropriée](/dkim_fr). * **Installer Roundcube** via l’interface d’administration YunoHost et tester l’envoi/réception d’email. @@ -166,7 +166,7 @@ Cette opération est longue mais à considérer pour avoir un serveur email irr ## Notes -* **Attention à la RAM** : sur le modèle A20-OLinuXino-LIME, les **512 Mo** partent vite. Les applications PHP ne sont pas très gourmandes, mais Searx et Etherpad Lite sont par exemple à installer avec des pincettes. +* **Attention à la RAM** : Sur le modèle A20-OLinuXino-LIME, les **512 Mo** partent vite. Les applications PHP ne sont pas très gourmandes, mais Searx et Etherpad Lite sont par exemple à installer avec des pincettes. * **Glances ne fonctionne pas** sur l’image *labriqueinternet_04-06-2015_jessie.img*, ce qui rend l’onglet **État du serveur** inaccessible dans l’interface d’adminstration de YunoHost. Une mise à jour future du noyau sera à prévoir pour corriger le problème. From b4b85605eb4e7cd46bf18093a0488d87f6101919 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 4 Jul 2015 21:23:28 +0200 Subject: [PATCH 068/229] Update installation_brique_fr.md --- installation_brique_fr.md | 44 +++++++++++++++++++-------------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index f994683d..5948eb8b 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -1,4 +1,4 @@ -# Installation d'une Brique Internet +# Installation d’une Brique Internet *Instructions basées sur l'image **[labriqueinternet_04-06-2015_jessie.img](http://repo.labriqueinter.net/labriqueinternet_04-06-2015_jessie.img.tar.xz)** et écrites début Juillet par kload chez **Neutrinet**.* @@ -8,10 +8,10 @@ Une **Brique Internet complète**, soit : * Une board [A20-OLinuXino-LIME](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/open-source-hardware) -* Une carte microSD (on utilise des [Trasncend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO) pour des raisons de perf/stabilité) +* Une carte microSD (on utilise des [Trasncend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO) pour des raisons de performance/stabilité) * Une antenne WiFi [MOD-WIFI-R5370-ANT](https://www.olimex.com/Products/USB-Modules/MOD-WIFI-R5370-ANT/) (seule version testée jusqu’à présent chez nous) * Un adaptateur secteur pour alimenter la brique ([chinois](https://www.olimex.com/Products/Power/SY0605E-CHINA/) ou [européen](https://www.olimex.com/Products/Power/SY0605E/)). L’alimentation via USB semble peu stable. -* Un câble Ethernet pour brancher la Brique à son routeur +* Un câble Ethernet/RJ-45 pour brancher la Brique à son routeur **+ un ordinateur sous UNIX** @@ -47,12 +47,12 @@ ssh root@192.168.4.2 6. Mettre à jour le système (environ 10 minutes), et pré-installer les paquets qui seront nécessaires aux applications **vpnclient** et **hotspot** (comme ça c'est fait). ```bash apt-get update && apt-get upgrade -apt-get install openvpn sipcalc hostapd iw dnsmasq firmware-linux-free firmware-linux-nonfree firmware-realtek firmware-ralink +apt-get install openvpn sipcalc hostapd iw dnsmasq firmware-linux-free firmware-linux-nonfree \ firmware-realtek firmware-ralink ``` --- -**Plus d'étapes pourront sans doute être automatisées dans cette partie à l’avenir.** +**Plus d’étapes pourront sans doute être automatisées dans cette partie à l’avenir.** --- @@ -71,7 +71,7 @@ Ajouter à la fin du fichier : 3. Procéder à la [postinstallation](/postinstallation_fr) en se connectant à la Brique sur https://michu.nohost.me. L’uilisateur pourra lui-même saisir le mot de passe d’administration qu'il souhaite lors de cette étape.
-**Note :** Il est possible de réaliser cette étape en ligne de commande via SSH en exécutant `yunohost tools postinstall` +**Note :** il est possible de réaliser cette étape en ligne de commande via SSH en exécutant `yunohost tools postinstall`
4. Se connecter en SSH et changer le mot de passe **root** (potentiellement par le même mot de passe que l’administration pour éviter la complexité). @@ -80,7 +80,7 @@ ssh root@michu.nohost.me passwd root ``` -5. **Fix temporaire** : La création des répertoires utilisateur ne se fait pas automatiquement dans cette image YunoHost pour la Brique. Il convient donc d'ajouter un script qui s'exécutera à la création des utilisateurs YunoHost et qui s’en assurera. +5. **Fix temporaire** : la création des répertoires utilisateur ne se fait pas automatiquement dans cette image YunoHost pour la Brique. Il convient donc d'ajouter un script qui s'exécutera à la création des utilisateurs YunoHost et qui s’en assurera. En SSH sur la Brique : ```bash mkdir -p /usr/share/yunohost/hooks/post_user_create @@ -93,21 +93,21 @@ mkhomedir_helper \$user EOF ``` -6. **Créer le premier utilisateur** : Se rendre dans l’interface d’administration YunoHost (ici https://michu.nohost.me/yunohost/admin), entrer le mot de passe d’administration puis se rendre dans **Utilisateurs** > **Nouvel utilisateur**. +6. **Créer le premier utilisateur** : se rendre dans l’interface d’administration YunoHost (ici https://michu.nohost.me/yunohost/admin), entrer le mot de passe d’administration puis se rendre dans **Utilisateurs** > **Nouvel utilisateur**.
Il faudra entrer un **nom d’utilisateur** sans majuscule/espace/tiret, un **nom/prénom/pseudo** en deux parties (obligatoires, merci LDAP) qui correspondra au nom qui apparaîtra sur les futurs emails de l’utilisateur, ainsi qu'un **quota d’email** éventuel et un **mot de passe** (*à ne pas confondre avec le mot de passe d’administration dans ce cas*).
-7. **Installer l’application VPN Client** : Se rendre dans **Applications** > **Installer**, et entrer `https://github.com/labriqueinternet/vpnclient_ynh` dans le champs **URL** du formulaire **Installer une application personnalisée** tout en bas de la page. +7. **Installer l’application VPN Client** : se rendre dans **Applications** > **Installer**, et entrer `https://github.com/labriqueinternet/vpnclient_ynh` dans le champs **URL** du formulaire **Installer une application personnalisée** tout en bas de la page. -8. (optionnel) **Restreindre l`accès à l’application VPN Client** : Se rendre dans **Applications** > **VPN Client** > **Accès** et sélectionner l’utilisateur précédemment créé, de sorte que les futurs potentiels nouveaux utilisateurs ne puissent pas modifier les paramètres d’accès VPN. +8. (optionnel) **Restreindre l’accès à l’application VPN Client** : se rendre dans **Applications** > **VPN Client** > **Accès** et sélectionner l’utilisateur précédemment créé, de sorte que les futurs potentiels nouveaux utilisateurs ne puissent pas modifier les paramètres d’accès VPN. -9. **Configurer l’application VPN Client** : Se connecter à l’**interface utilisateur** (ici https://michu.nohost.me/yunohost/sso/) et entrer les identifiants de l’utilisateur précédemment créé. L’application **VPN Client** devrait apparaître dans la liste d’application : +9. **Configurer l’application VPN Client** : se connecter à l’**interface utilisateur** (ici https://michu.nohost.me/yunohost/sso/) et entrer les identifiants de l’utilisateur précédemment créé. Vous devriez voir apparaître **VPN Client** dans votre liste d’application : De manière générale, il convient bien sûr d’éditer les paramètres en fonction de son fournisseur d’accès VPN. -Chez Neutrinet, nous éditons, dans **Advanced**, le template de configuration pour y ajouter 3 directives spécifiques: +Chez Neutrinet, nous éditons, dans **Advanced**, le template de configuration pour y ajouter trois directives spécifiques : 
resolv-retry infinite
 ns-cert-type server
 topology subnet
@@ -115,12 +115,12 @@ topology subnet **Attention** : le redémarrage du service, déclenché par le bouton **Save and reload**, peut mettre quelques minutes.
-10. **Installer l’application Hotspot** : S'assurer que l’antenne WiFi est bien branchée, et répéter les étapes **7**, **8** et **9** en installant à l’aide de l'URL `https://github.com/labriqueinternet/hotspot_ynh` +10. **Installer l’application Hotspot** : s'assurer que l’antenne WiFi est bien branchée, et répéter les étapes **7**, **8** et **9** en installant à l’aide de l'URL `https://github.com/labriqueinternet/hotspot_ynh` -11. **TESTEY** : La Brique devrait être accessible via l’IP publique que sa connexion VPN lui procure. Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, patienter quelques minutes que son IP se propage sur le serveur DNS de YunoHost. Si l’utilisateur a opté pour son propre nom de domaine, c’est le moment de [configurer ses enregistrements DNS](/dns_config_fr) correctement chez son registrar. +11. **TESTEY** : la Brique devrait être accessible via l’IP publique que sa connexion VPN lui procure. Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, patienter quelques minutes que son IP se propage sur le serveur DNS de YunoHost. Si l’utilisateur a opté pour son propre nom de domaine, c’est le moment de [configurer ses enregistrements DNS](/dns_config_fr) correctement chez son registrar. Si tout se passe bien côté **hotspot**, un réseau WiFi du nom choisi par l’utilisateur à l’étape 10 devrait être visible, et devrait vous router tout bien vers l’Internet. Il est possible de regarder l’IP avec laquelle on sort sur Internet [ici](http://ip.yunohost.org) (ou via `curl ip.yunohost.org` depuis le serveur) @@ -134,28 +134,28 @@ Il est possible de regarder l’IP avec laquelle on sort sur Internet [ici](http Ces étapes ne sont pas obligatoires mais peuvent améliorer considérablement l'**expérience de la Brique** (*fap fap fap*). -* **Supprimer le CRON DynDNS** : Si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, YunoHost a configuré automatiquement un client DynDNS sur la Brique qui va avertir le serveur DNS d’un potentiel changement d’IP publique. Or, l’IP fourni par la connexion VPN **est fixe**. Il convient donc de supprimer ce client, qui pourrait malencontreusement mettre à jour l’IP dans les DNS si la connexion VPN venait à tomber : +* **Supprimer le CRON DynDNS** : si l’utilisateur a opté pour un nom de domaine en **.nohost.me**, YunoHost a configuré automatiquement un client DynDNS sur la Brique qui va avertir le serveur DNS d’un potentiel changement d’IP publique. Or, l’IP fourni par la connexion VPN **est fixe**. Il convient donc de supprimer ce client, qui pourrait malencontreusement mettre à jour l’IP dans les DNS si la connexion VPN venait à tomber : ```bash rm /etc/cron.d/yunohost-dyndns ``` -* **S’assurer du nom de l’interface WiFi** : Lors du changement d’antenne WiFi (même si le modèle reste le même), il peut arriver que le nom de l’interface WiFi change, typiquement de `wlan0` à `wlan1`. Pour continuer à utiliser l’application **hotspot**, il faut se rendre sur l’interface web de configuration de l’application (étape 10) et mettre à jour le **Device**. +* **S’assurer du nom de l’interface WiFi** : lors du changement d’antenne WiFi (même si le modèle reste le même), il peut arriver que le nom de l’interface WiFi change, typiquement de `wlan0` à `wlan1`. Pour continuer à utiliser l’application **hotspot**, il faut se rendre sur l’interface web de configuration de l’application (étape 10) et mettre à jour le **Device**. -* **Ajouter un CRON de restart du service VPN** : Selon les paramètres VPN client et serveur, il peut arriver que la connexion soit instable, et que le client VPN tombe de temps en temps. Pour s’assurer qu’il redémarrera automatiquement, une bonne méthode *quick'n'dirty* et de tester que le service tourne et de le redémarrer dans le cas contraire : +* **Ajouter un CRON de restart du service VPN** : selon les paramètres VPN client et serveur, il peut arriver que la connexion soit instable, et que le client VPN tombe de temps en temps. Pour s’assurer qu’il redémarrera automatiquement, une bonne méthode *quick'n'dirty* et de tester que le service tourne et de le redémarrer dans le cas contraire : ```bash echo "* * * * * /usr/bin/pgrep openvpn || systemctl restart ynh-vpnclient" > /etc/cron.d/restart-vpn ``` -* **Ajouter un CRON de restart du service Amavisd** : Il peut arriver, notamment lorsque la Brique sature en RAM, que le service Amavisd s’arrête. Même *workaround* que pour le client VPN : +* **Ajouter un CRON de restart du service Amavisd** : il peut arriver, notamment lorsque la Brique sature en RAM, que le service Amavisd s’arrête. Même *workaround* que pour le client VPN : ```bash echo "0,30 * * * * /usr/bin/pgrep -u amavis amavi || systemctl restart amavis" > /etc/cron.d/restart-amavis ``` -* **Mettre à jour la configuration SSH** : Par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_confg` et de remplacer passer **PermitRootLogin** à **without-password**. +* **Mettre à jour la configuration SSH** : par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_confg` et de remplacer passer **PermitRootLogin** à **without-password**. -* **Configurer le reverse DNS** : Pour s’assurer du bon fonctionnement du serveur email, il est recommandé de configurer un reverse DNS pour son IP. En tant que FAI associatif, c’est un service faisable, autant en profiter ! +* **Configurer le reverse DNS** : pour s’assurer du bon fonctionnement du serveur email, il est recommandé de configurer un reverse DNS pour son IP. En tant que FAI associatif, c’est un service faisable, autant en profiter ! -* **Configurer le DKIM** : Avec un SPF et un PTR bien configuré dans les DNS, les emails envoyés par la Brique ne devrait pas être considérés comme spam. Ceci dit, GMail et d’autres dégraderont considérablement le spamscore si le DKIM n’est pas configuré également. +* **Configurer le DKIM** : avec un SPF et un PTR bien configuré dans les DNS, les emails envoyés par la Brique ne devrait pas être considérés comme spam. Ceci dit, GMail et d’autres dégraderont considérablement le spamscore si le DKIM n’est pas configuré également. Cette opération est longue mais à considérer pour avoir un serveur email irréprochable en production. Plus de renseignement sur [la page de documentation appropriée](/dkim_fr). * **Installer Roundcube** via l’interface d’administration YunoHost et tester l’envoi/réception d’email. @@ -166,7 +166,7 @@ Cette opération est longue mais à considérer pour avoir un serveur email irr ## Notes -* **Attention à la RAM** : Sur le modèle A20-OLinuXino-LIME, les **512 Mo** partent vite. Les applications PHP ne sont pas très gourmandes, mais Searx et Etherpad Lite sont par exemple à installer avec des pincettes. +* **Attention à la RAM** : sur le modèle A20-OLinuXino-LIME, les **512 Mo** partent vite. Les applications PHP ne sont pas très gourmandes, mais Searx et Etherpad Lite sont par exemple à installer avec des pincettes. * **Glances ne fonctionne pas** sur l’image *labriqueinternet_04-06-2015_jessie.img*, ce qui rend l’onglet **État du serveur** inaccessible dans l’interface d’adminstration de YunoHost. Une mise à jour future du noyau sera à prévoir pour corriger le problème. From 921131317daf438701137b936589500aff721060 Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Mon, 6 Jul 2015 17:26:04 +0200 Subject: [PATCH 069/229] Update installation_brique_fr.md --- installation_brique_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index 5948eb8b..cd67304b 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -148,7 +148,7 @@ echo "* * * * * /usr/bin/pgrep openvpn || systemctl restart ynh-vpnclient" > /et * **Ajouter un CRON de restart du service Amavisd** : il peut arriver, notamment lorsque la Brique sature en RAM, que le service Amavisd s’arrête. Même *workaround* que pour le client VPN : ```bash -echo "0,30 * * * * /usr/bin/pgrep -u amavis amavi || systemctl restart amavis" > /etc/cron.d/restart-amavis +echo "0,30 * * * * netstat -lntp | grep -v 10024 || systemctl restart amavis" > /etc/cron.d/restart-amavis ``` * **Mettre à jour la configuration SSH** : par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_confg` et de remplacer passer **PermitRootLogin** à **without-password**. From 6abf0f6b75fb5617911376b5657644a5a488a096 Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Mon, 6 Jul 2015 17:29:47 +0200 Subject: [PATCH 070/229] Update installation_brique_fr.md --- installation_brique_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index cd67304b..2933530f 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -148,7 +148,7 @@ echo "* * * * * /usr/bin/pgrep openvpn || systemctl restart ynh-vpnclient" > /et * **Ajouter un CRON de restart du service Amavisd** : il peut arriver, notamment lorsque la Brique sature en RAM, que le service Amavisd s’arrête. Même *workaround* que pour le client VPN : ```bash -echo "0,30 * * * * netstat -lntp | grep -v 10024 || systemctl restart amavis" > /etc/cron.d/restart-amavis +echo "0,30 * * * * netstat -lntp | grep -q 10024 || systemctl restart amavis" > /etc/cron.d/restart-amavis ``` * **Mettre à jour la configuration SSH** : par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_confg` et de remplacer passer **PermitRootLogin** à **without-password**. From 9ab700ca93ed113741bdb9c2603c159fb82597ff Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Mon, 6 Jul 2015 18:01:01 +0200 Subject: [PATCH 071/229] Update installation_brique_fr.md --- installation_brique_fr.md | 36 ++++++++++++++++++++++++++++++++++-- 1 file changed, 34 insertions(+), 2 deletions(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index 2933530f..f15af3bb 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -146,9 +146,41 @@ rm /etc/cron.d/yunohost-dyndns echo "* * * * * /usr/bin/pgrep openvpn || systemctl restart ynh-vpnclient" > /etc/cron.d/restart-vpn ``` -* **Ajouter un CRON de restart du service Amavisd** : il peut arriver, notamment lorsque la Brique sature en RAM, que le service Amavisd s’arrête. Même *workaround* que pour le client VPN : +* **Arrêter le service Amavis** : Amavis est un antivirus qui s’occupe de regarder si les pièces jointes des emails ne sont pas vérolées. Il est très lourd et tombe souvent en panne sur des petites machines comme la Brique. Pour arrêter Amavis, éditer le fichier `/etc/postfix/main.cf` et commenter la ligne 90 (normalement) : ```bash -echo "0,30 * * * * netstat -lntp | grep -q 10024 || systemctl restart amavis" > /etc/cron.d/restart-amavis +#content_filter = amavis:[127.0.0.1]:10024 +``` +Éditer également le fichier `/etc/postfix/master.cf` pour y commenter les lignes relatives à Amavis, vers les lignes 119-122: +```bash +#amavis unix - - - - 2 smtp +# -o smtp_data_done_timeout=1200 +# -o smtp_send_xforward_command=yes +# -o smtp_tls_note_starttls_offer=no +``` +Une fois ces éditions effectuées, redémarrer le service postfix et arrêter le service amavis : +```bash +systemctl restart postfix +systemctl stop amavis +systemctl disable amavis +``` + +* **Arrêter le service postgrey** : Postgrey est un méchanisme antivirus qui est assez peu efficace, et surtout assez pénible. Il refuse les emails en premier lieu lorsque qu’ils proviennent d’une source inconnue. Un serveur email de spam ne fait pas toujours l’effort de renvoyer le spam une seconde fois. Pour arrêter postgrey, il faut éditer le fichier `/etc/postfix/main.cf` et commenter la ligne relative à postgrey (ligne 132) : +```bash +smtpd_recipient_restrictions = + permit_mynetworks, + permit_sasl_authenticated, + reject_non_fqdn_recipient, + reject_unknown_recipient_domain, + reject_unauth_destination, + check_policy_service unix:private/policy-spf +# check_policy_service inet:127.0.0.1:10023 + permit +``` +Une fois le fichier éditer, redémarrer le service postfix, et désactiver postgrey : +```bash +systemctl restart postfix +systemctl stop postgrey +systemctl disable postgrey ``` * **Mettre à jour la configuration SSH** : par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_confg` et de remplacer passer **PermitRootLogin** à **without-password**. From 0deedfcc2569d44512600870222f37320b2456cc Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Tue, 7 Jul 2015 11:09:55 +0200 Subject: [PATCH 072/229] Update installation_brique_fr.md --- installation_brique_fr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index f15af3bb..9b83cb77 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -35,7 +35,7 @@ sudo dd if=labriqueinternet_XX-XX-XXXX_jessie.img of=/dev/sdX bs=1M Le premier démarrage peut mettre une grosse minute car la partition est redimensionnée et la board redémarrée automatiquement.
-4. Récupérer l’adresse IP locale de la Brique, soit avec une commande comme `nmap -T4 -sP 192.168.x.0/24`, soit via l'interface du routeur listant les clients DHCP, soit en branchant un écran en HDMI à la Brique. +4. Récupérer l’adresse IP locale de la Brique, soit avec une commande comme `arp-scan --local | grep -P '\t02'`, soit via l'interface du routeur listant les clients DHCP, soit en branchant un écran en HDMI à la Brique. Pour info, l'adresse MAC des boards A20-OLinuXino-LIME commence par `02`.
Admettons que l’adresse IP locale de la Brique soit **192.168.4.2**
@@ -143,7 +143,7 @@ rm /etc/cron.d/yunohost-dyndns * **Ajouter un CRON de restart du service VPN** : selon les paramètres VPN client et serveur, il peut arriver que la connexion soit instable, et que le client VPN tombe de temps en temps. Pour s’assurer qu’il redémarrera automatiquement, une bonne méthode *quick'n'dirty* et de tester que le service tourne et de le redémarrer dans le cas contraire : ```bash -echo "* * * * * /usr/bin/pgrep openvpn || systemctl restart ynh-vpnclient" > /etc/cron.d/restart-vpn +echo "* * * * * root /sbin/ifconfig tun0 > /dev/null || systemctl restart ynh-vpnclient" > /etc/cron.d/restart-vpn ``` * **Arrêter le service Amavis** : Amavis est un antivirus qui s’occupe de regarder si les pièces jointes des emails ne sont pas vérolées. Il est très lourd et tombe souvent en panne sur des petites machines comme la Brique. Pour arrêter Amavis, éditer le fichier `/etc/postfix/main.cf` et commenter la ligne 90 (normalement) : From d340e702a295b5183bdba7e42df83805afc7210a Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Tue, 7 Jul 2015 11:16:23 +0200 Subject: [PATCH 073/229] Update installation_brique_fr.md --- installation_brique_fr.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index 9b83cb77..db1e8e31 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -146,7 +146,8 @@ rm /etc/cron.d/yunohost-dyndns echo "* * * * * root /sbin/ifconfig tun0 > /dev/null || systemctl restart ynh-vpnclient" > /etc/cron.d/restart-vpn ``` -* **Arrêter le service Amavis** : Amavis est un antivirus qui s’occupe de regarder si les pièces jointes des emails ne sont pas vérolées. Il est très lourd et tombe souvent en panne sur des petites machines comme la Brique. Pour arrêter Amavis, éditer le fichier `/etc/postfix/main.cf` et commenter la ligne 90 (normalement) : +* **Arrêter le service Amavis** : *(**EDIT**: en fait Amavis est branché à SpamAssassin, donc ça enlève l'antispam, ce qui est pénible)* +Amavis est un antivirus qui s’occupe de regarder si les pièces jointes des emails ne sont pas vérolées. Il est très lourd et tombe souvent en panne sur des petites machines comme la Brique. Pour arrêter Amavis, éditer le fichier `/etc/postfix/main.cf` et commenter la ligne 90 (normalement) : ```bash #content_filter = amavis:[127.0.0.1]:10024 ``` @@ -176,11 +177,9 @@ smtpd_recipient_restrictions = # check_policy_service inet:127.0.0.1:10023 permit ``` -Une fois le fichier éditer, redémarrer le service postfix, et désactiver postgrey : +Une fois le fichier éditer, redémarrer le service postfix : ```bash systemctl restart postfix -systemctl stop postgrey -systemctl disable postgrey ``` * **Mettre à jour la configuration SSH** : par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_confg` et de remplacer passer **PermitRootLogin** à **without-password**. From b2b5777728d8560ab0ca39eabcb0efc10c231699 Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Tue, 7 Jul 2015 18:39:00 +0200 Subject: [PATCH 074/229] Update installation_brique_fr.md --- installation_brique_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index db1e8e31..1fdaa145 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -89,7 +89,7 @@ cat > /usr/share/yunohost/hooks/post_user_create/06-create_userdir < Date: Thu, 9 Jul 2015 17:38:53 +0200 Subject: [PATCH 075/229] Update installation_brique_fr.md --- installation_brique_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index 1fdaa145..de09a357 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -23,7 +23,7 @@ L’ordre des étapes est important :-) ## Étapes préliminaires -1. Télécharger l’image à partir de https://repo.labriqueinter.net, valider son checksum. +1. Télécharger l’image à partir de https://repo.labriqueinter.net, valider son checksum, puis la décompresser. 2. Copier l'image sur la carte à l'aide de `dd` (la commande, pas le patron du bistro d’en face) ```bash From 009e18762a9b79b4a87d621e66f9dcdf64814bee Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Mon, 13 Jul 2015 15:24:57 +0200 Subject: [PATCH 076/229] Update installation_brique_fr.md --- installation_brique_fr.md | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index de09a357..a6266bbb 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -7,7 +7,7 @@ ## Prérequis Une **Brique Internet complète**, soit : -* Une board [A20-OLinuXino-LIME](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/open-source-hardware) +* Une board [A20-OLinuXino-LIME](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/open-source-hardware) ou [A20-OLinuXino-LIME2](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME2/open-source-hardware) * Une carte microSD (on utilise des [Trasncend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO) pour des raisons de performance/stabilité) * Une antenne WiFi [MOD-WIFI-R5370-ANT](https://www.olimex.com/Products/USB-Modules/MOD-WIFI-R5370-ANT/) (seule version testée jusqu’à présent chez nous) * Un adaptateur secteur pour alimenter la brique ([chinois](https://www.olimex.com/Products/Power/SY0605E-CHINA/) ou [européen](https://www.olimex.com/Products/Power/SY0605E/)). L’alimentation via USB semble peu stable. @@ -30,21 +30,29 @@ L’ordre des étapes est important :-) sudo dd if=labriqueinternet_XX-XX-XXXX_jessie.img of=/dev/sdX bs=1M ``` -3. Mettre la carte SD dans une Brique, brancher le câble Ethernet et l’alimentation. Elle démarre normalement toute seule, et les LEDs du port Ethernet se mettent à clignoter au bout de 10 secondes maximum. +3. **Uniquement pour le modèle LIME2** : Monter la carte SD et changer le lien de base donnée des pilotes dans `/boot` : +```bash +sudo mount /dev/sdX1 /mnt +cd /mnt/boot/ +sudo rm board.dtb +sudo ln -sf /boot/dtb/sun7i-a20-olinuxino-lime2.dtb board.dtb +``` + +4. Mettre la carte SD dans une Brique, brancher le câble Ethernet et l’alimentation. Elle démarre normalement toute seule, et les LEDs du port Ethernet se mettent à clignoter au bout de 10 secondes maximum.
Le premier démarrage peut mettre une grosse minute car la partition est redimensionnée et la board redémarrée automatiquement.
-4. Récupérer l’adresse IP locale de la Brique, soit avec une commande comme `arp-scan --local | grep -P '\t02'`, soit via l'interface du routeur listant les clients DHCP, soit en branchant un écran en HDMI à la Brique. Pour info, l'adresse MAC des boards A20-OLinuXino-LIME commence par `02`. +5. Récupérer l’adresse IP locale de la Brique, soit avec une commande comme `arp-scan --local | grep -P '\t02'`, soit via l'interface du routeur listant les clients DHCP, soit en branchant un écran en HDMI à la Brique. Pour info, l'adresse MAC des boards A20-OLinuXino-LIME commence par `02`.
Admettons que l’adresse IP locale de la Brique soit **192.168.4.2**
-5. Se connecter en SSH en root à la Brique, le mot de passe est **olinux** par défaut. Le changer par un mot de passe temporaire à modifier avec l’utilisateur par la suite. +6. Se connecter en SSH en root à la Brique, le mot de passe est **olinux** par défaut. Le changer par un mot de passe temporaire à modifier avec l’utilisateur par la suite. ```bash ssh root@192.168.4.2 ``` -6. Mettre à jour le système (environ 10 minutes), et pré-installer les paquets qui seront nécessaires aux applications **vpnclient** et **hotspot** (comme ça c'est fait). +7. Mettre à jour le système (environ 10 minutes), et pré-installer les paquets qui seront nécessaires aux applications **vpnclient** et **hotspot** (comme ça c'est fait). ```bash apt-get update && apt-get upgrade apt-get install openvpn sipcalc hostapd iw dnsmasq firmware-linux-free firmware-linux-nonfree \ firmware-realtek firmware-ralink @@ -143,7 +151,7 @@ rm /etc/cron.d/yunohost-dyndns * **Ajouter un CRON de restart du service VPN** : selon les paramètres VPN client et serveur, il peut arriver que la connexion soit instable, et que le client VPN tombe de temps en temps. Pour s’assurer qu’il redémarrera automatiquement, une bonne méthode *quick'n'dirty* et de tester que le service tourne et de le redémarrer dans le cas contraire : ```bash -echo "* * * * * root /sbin/ifconfig tun0 > /dev/null || systemctl restart ynh-vpnclient" > /etc/cron.d/restart-vpn +echo "* * * * * root /sbin/ifconfig tun0 > /dev/null 2>&1 || systemctl restart ynh-vpnclient" > /etc/cron.d/restart-vpn ``` * **Arrêter le service Amavis** : *(**EDIT**: en fait Amavis est branché à SpamAssassin, donc ça enlève l'antispam, ce qui est pénible)* From e02fdc7d856c586b3a144e42e6b6ec23cd255a97 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 15 Jul 2015 01:41:21 +0200 Subject: [PATCH 077/229] Update apps_wishlist.md --- apps_wishlist.md | 1 + 1 file changed, 1 insertion(+) diff --git a/apps_wishlist.md b/apps_wishlist.md index d799d59c..a9a7dcaf 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -13,6 +13,7 @@ The following list is a compiled wishlist of applications that would be nice-to- * [Browsepass](http://techualization.blogspot.de/2013/09/introducing-browsepass-keepass-on-web.html) * [Caliopen](https://www.caliopen.org/) * [CardDavMate](https://www.inf-it.com/open-source/clients/carddavmate/) +* [cgit](http://git.zx2c4.com/cgit/about/) * [CumulusClips](http://cumulusclips.org/) * [DemocracyOS](http://democracyos.org/) * [Discourse](http://discourse.org/) From a8c5ee7a660e8c892019cd146d4e786a26306aaa Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 15 Jul 2015 14:48:25 +0200 Subject: [PATCH 078/229] Add faq.md --- faq.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 faq.md diff --git a/faq.md b/faq.md new file mode 100644 index 00000000..74196678 --- /dev/null +++ b/faq.md @@ -0,0 +1,7 @@ +# Frequently asked questions + +### YunoHost ported on Ubuntu? +YunoHost team does not have energy to port and maintain YunoHost on Ubuntu. + +### YunoHost licenses +All packages are under GNU AGPL v.3. From e7315dd5a80ae090ed008b1d368e65a79593d849 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 15 Jul 2015 14:59:04 +0200 Subject: [PATCH 079/229] Update faq.md --- faq.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/faq.md b/faq.md index 74196678..77a43286 100644 --- a/faq.md +++ b/faq.md @@ -3,5 +3,9 @@ ### YunoHost ported on Ubuntu? YunoHost team does not have energy to port and maintain YunoHost on Ubuntu. -### YunoHost licenses -All packages are under GNU AGPL v.3. +### YunoHost is distributed under which license? +YunoHost packages are under free licenses GNU AGPL v.3. + +YunoHost is based on Debian, so on licenses of Debian based elements. + +Applications and applications packages have there respectives licenses. \ No newline at end of file From d8d8527b37d56c5831764e515c223bbbfc3c6aa1 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 15 Jul 2015 14:59:30 +0200 Subject: [PATCH 080/229] Add faq_fr.md --- faq_fr.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 faq_fr.md diff --git a/faq_fr.md b/faq_fr.md new file mode 100644 index 00000000..f2289435 --- /dev/null +++ b/faq_fr.md @@ -0,0 +1,12 @@ +# Foire aux questions + +### Es-ce que YunoHost est porté sous Ubuntu ? +L’équipe de YunoHost n’a pas l’énergie de porter ni de maintenir YunoHost sur Ubuntu. + +### YunoHost est distribuée sous quelle licence ? +Les paquets qui composent YunoHost sont sous licence libre GNU AGPL v.3. + +YunoHost est basé sur Debian, donc sur les licences des éléments sur lequels Debian est basé. + +Les applications et les packages d’applications ont leurs licences respectives. + From 8e5afe676fbe9b0b493eb297d88465bcab3ed9a9 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 15 Jul 2015 14:59:52 +0200 Subject: [PATCH 081/229] Update faq_fr.md --- faq_fr.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/faq_fr.md b/faq_fr.md index f2289435..7e583380 100644 --- a/faq_fr.md +++ b/faq_fr.md @@ -8,5 +8,4 @@ Les paquets qui composent YunoHost sont sous licence libre GNU AGPL v.3. YunoHost est basé sur Debian, donc sur les licences des éléments sur lequels Debian est basé. -Les applications et les packages d’applications ont leurs licences respectives. - +Les applications et les packages d’applications ont leurs licences respectives. \ No newline at end of file From f4f4619a16da58263560e61afb240658b408d621 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 15 Jul 2015 15:01:02 +0200 Subject: [PATCH 082/229] Update sitemap_fr.md --- sitemap_fr.md | 1 + 1 file changed, 1 insertion(+) diff --git a/sitemap_fr.md b/sitemap_fr.md index 814f3096..d18bf0b7 100644 --- a/sitemap_fr.md +++ b/sitemap_fr.md @@ -99,6 +99,7 @@ * [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) * [Contributeurs](contribs_fr) * [Entraide - support](/support_fr) * [Blog](https://forum.yunohost.org/c/announcement) From 4e06b9a650f145c43d406b991f431952318ead0d Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 15 Jul 2015 15:02:07 +0200 Subject: [PATCH 083/229] Update sitemap.md --- sitemap.md | 1 + 1 file changed, 1 insertion(+) diff --git a/sitemap.md b/sitemap.md index ebfe1298..b195b27a 100644 --- a/sitemap.md +++ b/sitemap.md @@ -94,6 +94,7 @@ * [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) * [Support](/support_en) * [Art Works](artworks_en) From 744b6f674fe630faa9dd7e04e5ae74c529e430c3 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 15 Jul 2015 15:03:30 +0200 Subject: [PATCH 084/229] Update apps_wishlist.md --- apps_wishlist.md | 1 + 1 file changed, 1 insertion(+) diff --git a/apps_wishlist.md b/apps_wishlist.md index a9a7dcaf..4e1ed1fa 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -37,6 +37,7 @@ The following list is a compiled wishlist of applications that would be nice-to- * [Inbox](https://www.inboxapp.com/) * [InfCloud](https://www.inf-it.com/open-source/clients/infcloud/) * [Jitsi Meet](https://github.com/jitsi/jitsi-meet) +* [Joomla!](https://www.joomla.org/) * [jsFiddle](http://jsbin.com/help/2-second-setup) * [Kaiwa](http://getkaiwa.com/) * [Known](https://withknown.com/) From 934e12d6b50e0bd83ae91712e545d86f43b87104 Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Wed, 15 Jul 2015 21:45:47 +0200 Subject: [PATCH 085/229] Update installation_brique_fr.md --- installation_brique_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index a6266bbb..942b7cb9 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -55,7 +55,7 @@ ssh root@192.168.4.2 7. Mettre à jour le système (environ 10 minutes), et pré-installer les paquets qui seront nécessaires aux applications **vpnclient** et **hotspot** (comme ça c'est fait). ```bash apt-get update && apt-get upgrade -apt-get install openvpn sipcalc hostapd iw dnsmasq firmware-linux-free firmware-linux-nonfree \ firmware-realtek firmware-ralink +apt-get install openvpn sipcalc hostapd iw dnsmasq firmware-linux-free firmware-linux-nonfree firmware-realtek firmware-ralink ``` --- From 762fba06a2da1d96ef99637cf52326336f39c92c Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Thu, 30 Jul 2015 17:34:31 +0200 Subject: [PATCH 086/229] Update apps_in_progress.md --- apps_in_progress.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/apps_in_progress.md b/apps_in_progress.md index 70b878ac..807338ad 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -99,6 +99,8 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Subsonic](http://subsonic.org) | tifred |
| https://github.com/drfred1981/subsonic_ynh | Web-based media server | | [Syncthing](https://syncthing.net/) | tuxmouraille |
| https://github.com/tuxmouraille/syncthing_ynh | Sync and encrypted service | | [TagSpaces](http://www.tagspaces.org/) | scith |
| https://github.com/scith/tagspaces_ynh | Manage files using tags | +| [Telegram](http://www.telegram.org/) | Cyp |
| +https://github.com/magikcypress/telegram_ynh | a new era of messaging | | Tor Client | Bleuchtang |
| https://github.com/labriqueinternet/torclient_ynh| Tor Client for [the Brick](/install_brick) | | [Tor Relay](https://www.torproject.org/docs/tor-doc-relay.html.en) | matlink |
| https://github.com/matlink/torrelay_ynh | Tor node | | [uCoin](http://ucoin.io/) | Moul |
| https://github.com/ucoin-io/ucoin_ynh | uCoin node:
free monetary system | @@ -150,4 +152,4 @@ $(document).ready(function () { }); }); - + \ No newline at end of file From 9e4ff28fa5d5b0f7ebfdc5f2ea470f4dc79951a0 Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Thu, 30 Jul 2015 17:36:19 +0200 Subject: [PATCH 087/229] Update apps_in_progress.md --- apps_in_progress.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/apps_in_progress.md b/apps_in_progress.md index 807338ad..d6bff127 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -99,8 +99,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Subsonic](http://subsonic.org) | tifred |
| https://github.com/drfred1981/subsonic_ynh | Web-based media server | | [Syncthing](https://syncthing.net/) | tuxmouraille |
| https://github.com/tuxmouraille/syncthing_ynh | Sync and encrypted service | | [TagSpaces](http://www.tagspaces.org/) | scith |
| https://github.com/scith/tagspaces_ynh | Manage files using tags | -| [Telegram](http://www.telegram.org/) | Cyp |
| -https://github.com/magikcypress/telegram_ynh | a new era of messaging | +| [Telegram](http://www.telegram.org/) | Cyp |
| https://github.com/magikcypress/telegram_ynh | a new era of messaging | | Tor Client | Bleuchtang |
| https://github.com/labriqueinternet/torclient_ynh| Tor Client for [the Brick](/install_brick) | | [Tor Relay](https://www.torproject.org/docs/tor-doc-relay.html.en) | matlink |
| https://github.com/matlink/torrelay_ynh | Tor node | | [uCoin](http://ucoin.io/) | Moul |
| https://github.com/ucoin-io/ucoin_ynh | uCoin node:
free monetary system | From cf121b008ea6fcee1a895e41d3613893a05e4ee4 Mon Sep 17 00:00:00 2001 From: "julien.malik@paraiso.me" Date: Fri, 31 Jul 2015 11:26:17 +0200 Subject: [PATCH 088/229] Update apps_in_progress.md --- apps_in_progress.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apps_in_progress.md b/apps_in_progress.md index d6bff127..22105f99 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -99,7 +99,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Subsonic](http://subsonic.org) | tifred |
| https://github.com/drfred1981/subsonic_ynh | Web-based media server | | [Syncthing](https://syncthing.net/) | tuxmouraille |
| https://github.com/tuxmouraille/syncthing_ynh | Sync and encrypted service | | [TagSpaces](http://www.tagspaces.org/) | scith |
| https://github.com/scith/tagspaces_ynh | Manage files using tags | -| [Telegram](http://www.telegram.org/) | Cyp |
| https://github.com/magikcypress/telegram_ynh | a new era of messaging | +| [Telegram](http://www.telegram.org/) | Cyp |
| https://github.com/magikcypress/telegram_ynh | a new era of messaging | | Tor Client | Bleuchtang |
| https://github.com/labriqueinternet/torclient_ynh| Tor Client for [the Brick](/install_brick) | | [Tor Relay](https://www.torproject.org/docs/tor-doc-relay.html.en) | matlink |
| https://github.com/matlink/torrelay_ynh | Tor node | | [uCoin](http://ucoin.io/) | Moul |
| https://github.com/ucoin-io/ucoin_ynh | uCoin node:
free monetary system | From ddd11b4e649dda27a289fa1e2818c82355981fba Mon Sep 17 00:00:00 2001 From: "isserterrus@switchserver.fr" Date: Fri, 31 Jul 2015 11:41:53 +0200 Subject: [PATCH 089/229] Update apps_wishlist.md --- apps_wishlist.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apps_wishlist.md b/apps_wishlist.md index 4e1ed1fa..d892e27c 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -74,7 +74,7 @@ The following list is a compiled wishlist of applications that would be nice-to- * [SIP](https://en.wikipedia.org/wiki/List_of_SIP_software#Free_and_open-source_license) * [Sonerezh](https://github.com/Sonerezh) * [Streisand](https://github.com/jlund/streisand) -* [SVG-Edit](https://code.google.com/p/svg-edit/) +* [SVG-Edit](https://github.com/SVG-Edit/svgedit) * [Sympa](http://www.sympa.org/) * [Syncthing](http://syncthing.net/) * [Taiga](https://taiga.io/) From 7ef1b14be93052008cc2e2f6a76b8a6f94a3165f Mon Sep 17 00:00:00 2001 From: "julien.malik@paraiso.me" Date: Fri, 31 Jul 2015 13:58:21 +0200 Subject: [PATCH 090/229] Update apps_wishlist.md --- apps_wishlist.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/apps_wishlist.md b/apps_wishlist.md index d892e27c..fd803cf4 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -54,6 +54,7 @@ The following list is a compiled wishlist of applications that would be nice-to- * [Modoboa](http://modoboa.org/) * [Mopidy](https://www.mopidy.com/) * [Movim](http://www.movim.eu/) +* [Only Office](http://onlyoffice.org/) * [pdfy](https://github.com/joepie91/pdfy) * [Pelican](http://blog.getpelican.com/) * [PHPList](http://www.phplist.com/) @@ -70,6 +71,7 @@ The following list is a compiled wishlist of applications that would be nice-to- * [Scramble, Browser-based PGP web mail](https://github.com/dcposch/scramble) * [Scribbleton](https://scribbleton.com/) * [scrumblr](http://scrumblr.ca/) +* [ShareLatex](https://www.sharelatex.com/) * [Shleuder](http://schleuder2.nadir.org/) * [SIP](https://en.wikipedia.org/wiki/List_of_SIP_software#Free_and_open-source_license) * [Sonerezh](https://github.com/Sonerezh) From 612a87a223525fb0e9e9d5964a183e7e5d37c860 Mon Sep 17 00:00:00 2001 From: "valentin@grimaud.me" Date: Sat, 1 Aug 2015 01:14:45 +0200 Subject: [PATCH 091/229] Update apps_in_progress.md --- apps_in_progress.md | 1 + 1 file changed, 1 insertion(+) diff --git a/apps_in_progress.md b/apps_in_progress.md index 22105f99..499fbfc8 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -29,6 +29,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [COPS](http://cops.com) | lunarok |
| https://github.com/lunarok/cops_ynh | Frontend for Calibre library | | [Coquelicot](https://coquelicot.potager.org/) | Moul |
| https://github.com/M5oul/coquelicot_ynh | “One-click” file sharing focused on users’ privacy | | [Couchpotato](https://couchpota.to/) | Chao-Man |
| https://github.com/Chao-Man/couchpotato_ynh | PVR for Usenet and torrents | +| [Covoiturage](https://github.com/SebGit/covoiturage-libre) | ljf |
| https://git.framasoft.org/ljf/covoiturage_ynh | Car sharing app (french only) | | [Cubiks-2048](https://kshitij-banerjee.github.io/Cubiks-2048/) | Moul |
| https://github.com/M5oul/Cubiks-2048_ynh | Clone of 2048 game in 3D | | Custom Webapp (Multi instance) | Maniack Crudelis |
| https://github.com/maniackcrudelis/my_webapp_ynh |Custom Webapp | | [Diaspora](http://diasporafoundation.org) | aymhce |
| https://github.com/aymhce/diaspora_ynh | Distributed social networking service | From 8248cfc3cc9de9c294253fd35094fedffadcf114 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 1 Aug 2015 16:21:51 +0200 Subject: [PATCH 092/229] Update install_iso.md --- install_iso.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/install_iso.md b/install_iso.md index 4b3af9ce..c9a3402d 100644 --- a/install_iso.md +++ b/install_iso.md @@ -15,7 +15,7 @@ You can reuse any computer with **256MB RAM or more**. * A **USB key** of at least 1GB capacity **OR** a standard **blank CD** * One of the latest **YunoHost ISO images**, available here (take the 32 bits one if you don't know which one to choose):
- Torent: + Torrent:
  • [32 bits](http://build.yunohost.org/yunohostv2-latest-i386.iso.torrent)
  • [64 bits](http://build.yunohost.org/yunohostv2-latest-amd64.iso.torrent)
    • From aa406ab06b5337aeeb055374d790b23f7025b21e Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 2 Aug 2015 22:41:15 +0200 Subject: [PATCH 093/229] Update apps_wishlist.md --- apps_wishlist.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/apps_wishlist.md b/apps_wishlist.md index fd803cf4..84f0c36a 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -9,6 +9,7 @@ The following list is a compiled wishlist of applications that would be nice-to- * [10er10](https://github.com/dready92/10er10) * [Ajenti](http://ajenti.org/) * [Autoblog](https://github.com/mitsukarenai/Projet-Autoblog) +* [Bolt](http://bolt.cm) * [Bootstrap](http://getbootstrap.com/) * [Browsepass](http://techualization.blogspot.de/2013/09/introducing-browsepass-keepass-on-web.html) * [Caliopen](https://www.caliopen.org/) @@ -55,6 +56,7 @@ The following list is a compiled wishlist of applications that would be nice-to- * [Mopidy](https://www.mopidy.com/) * [Movim](http://www.movim.eu/) * [Only Office](http://onlyoffice.org/) +* [Paperwork](http://paperwork.rocks) * [pdfy](https://github.com/joepie91/pdfy) * [Pelican](http://blog.getpelican.com/) * [PHPList](http://www.phplist.com/) From ac49c9dfe1f5a5bceb5045bde78243a6c8a0257e Mon Sep 17 00:00:00 2001 From: "julien.malik@paraiso.me" Date: Tue, 4 Aug 2015 11:05:20 +0200 Subject: [PATCH 094/229] Update apps_in_progress.md --- apps_in_progress.md | 1 + 1 file changed, 1 insertion(+) diff --git a/apps_in_progress.md b/apps_in_progress.md index 499fbfc8..bab87017 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -54,6 +54,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Gogs](http://gogs.io/) | tostaki |
    | https://github.com/mbugeia/gogs_ynh | self-hosted Git service | | [Jeedom](http://jeedom.fr) | lunarok |
    | https://github.com/lunarok/jeedom_ynh | Home automation | | [Jenkins](http://jenkins-ci.org/) | ju |
    | https://github.com/julienmalik/jenkins_ynh | Continuous Integration platform | +| [Jitsi Meet](https://jitsi.org/Projects/JitsiMeet) | ju |
    | https://github.com/julienmalik/jitsi_ynh | Audio/Video web conferencing | | [Kanboard](http://kanboard.net/) | tostaki |
    | https://github.com/mbugeia/kanboard_ynh | Visual task board | | [KiwiIRC](http://kiwiirc.com) | ju |
    | https://github.com/julienmalik/kiwiirc_ynh | Web IRC client | | [Laverna](https://laverna.cc/) | anaqreon |
    | https://github.com/anaqreon/laverna_ynh | Note taking app | From 2314c195528a181be6a4c158ce931942348e3e10 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 6 Aug 2015 15:29:26 +0200 Subject: [PATCH 095/229] Update faq.md --- faq.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/faq.md b/faq.md index 77a43286..457f4a85 100644 --- a/faq.md +++ b/faq.md @@ -1,11 +1,14 @@ # Frequently asked questions -### YunoHost ported on Ubuntu? +#### YunoHost ported on Ubuntu? YunoHost team does not have energy to port and maintain YunoHost on Ubuntu. -### YunoHost is distributed under which license? +#### YunoHost is distributed under which license? YunoHost packages are under free licenses GNU AGPL v.3. YunoHost is based on Debian, so on licenses of Debian based elements. -Applications and applications packages have there respectives licenses. \ No newline at end of file +Applications and applications packages have there respectives licenses. + +#### Can we host many independents websites with differents domain names? +We can host many websites cause YunoHost is multi-domain and that some applications for websites management, like *WordPress* or *Web App Multi Custom*, are multi-instances, which means that the application can be installed many times. \ No newline at end of file From acb7b388c13fd6cadeedce49af2a80897eb04c82 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Thu, 6 Aug 2015 15:29:45 +0200 Subject: [PATCH 096/229] Update faq_fr.md --- faq_fr.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/faq_fr.md b/faq_fr.md index 7e583380..1e20d766 100644 --- a/faq_fr.md +++ b/faq_fr.md @@ -1,11 +1,14 @@ # Foire aux questions -### Es-ce que YunoHost est porté sous Ubuntu ? +#### Es-ce que YunoHost est porté sous Ubuntu ? L’équipe de YunoHost n’a pas l’énergie de porter ni de maintenir YunoHost sur Ubuntu. -### YunoHost est distribuée sous quelle licence ? +#### YunoHost est distribuée sous quelle licence ? Les paquets qui composent YunoHost sont sous licence libre GNU AGPL v.3. YunoHost est basé sur Debian, donc sur les licences des éléments sur lequels Debian est basé. -Les applications et les packages d’applications ont leurs licences respectives. \ No newline at end of file +Les applications et les packages d’applications ont leurs licences respectives. + +#### Peut-on héberger plusieurs sites indépendants avec des nom de domaines différents ? +On peut tout à fait héberger plusieurs sites web car YunoHost est multi-domaine et que certaines applications de gestion de sites web, comme *WordPress* ou *Web App Multi Custom*, sont multi-instances, c’est-à-dire que l’applications peut-être installée plusieurs fois. From 7c18c71e9573e68ce19bb2025a3723bfc919046a Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Fri, 7 Aug 2015 09:17:12 +0200 Subject: [PATCH 097/229] Update apps_wishlist.md --- apps_wishlist.md | 1 + 1 file changed, 1 insertion(+) diff --git a/apps_wishlist.md b/apps_wishlist.md index 84f0c36a..57f7dfbb 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -55,6 +55,7 @@ The following list is a compiled wishlist of applications that would be nice-to- * [Modoboa](http://modoboa.org/) * [Mopidy](https://www.mopidy.com/) * [Movim](http://www.movim.eu/) +* [Nibbleblog](http://www.nibbleblog.com) * [Only Office](http://onlyoffice.org/) * [Paperwork](http://paperwork.rocks) * [pdfy](https://github.com/joepie91/pdfy) From a04c4792afe83ad530e28d6c6722bd9ffede842a Mon Sep 17 00:00:00 2001 From: "valentin@grimaud.me" Date: Sat, 8 Aug 2015 02:09:02 +0200 Subject: [PATCH 098/229] Update copy_image_fr.md --- copy_image_fr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/copy_image_fr.md b/copy_image_fr.md index 92be7e6b..afe38624 100644 --- a/copy_image_fr.md +++ b/copy_image_fr.md @@ -36,9 +36,9 @@ sudo dd if=/chemin/vers/votre/.img of=/nom/du/matériel La commande peut prendre quelques minutes, puis votre carte SD sera prête à être utilisée. **:-)** -## Étendre la partition root (facultatif) +## Étendre la partition root (facultatif, mais conseillé) -Par défaut, la partition root de votre carte SD est très petite. +Par défaut, la partition root installée sur votre carte SD avec la commande `dd` est très petite. Vous pouvez la redimensionner avec un logiciel comme `resize2fs` (ligne de commande) ou `Gparted` (interface graphique) en étendant la partition ext4 au maximum de façon à utiliser tout l’espace non-alloué. From 579308cc24a784771960837d719624b7f212731c Mon Sep 17 00:00:00 2001 From: "opi@no-log.org" Date: Sun, 9 Aug 2015 09:49:39 +0200 Subject: [PATCH 099/229] Update installation_brique_fr.md --- installation_brique_fr.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index 942b7cb9..03b66463 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -1,5 +1,9 @@ # Installation d’une Brique Internet +
    +Site du projet **La Brique Internet**: http://labriqueinter.net/ +
    + *Instructions basées sur l'image **[labriqueinternet_04-06-2015_jessie.img](http://repo.labriqueinter.net/labriqueinternet_04-06-2015_jessie.img.tar.xz)** et écrites début Juillet par kload chez **Neutrinet**.* ![brique](https://yunohost.org/images/thisisinternet.png) From 7f7c95cd9b179e46b8d4b2c1381f70661fce99f5 Mon Sep 17 00:00:00 2001 From: "opi@no-log.org" Date: Sun, 9 Aug 2015 09:51:46 +0200 Subject: [PATCH 100/229] Update apps_in_progress.md --- apps_in_progress.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/apps_in_progress.md b/apps_in_progress.md index bab87017..d3875f53 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -42,7 +42,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [FreshRSS](http://freshrss.org/) | plopoyop |
    | https://github.com/plopoyop/freshrss_ynh | RSS reader | | [Friendica](http://friendica.com) | aymhce |
    | https://github.com/aymhce/friendica_ynh | Social Communication Server | | FTP support for webapp | Maniack Crudelis |
    | https://github.com/maniackcrudelis/ftp_support_webapp_ynh | FTP support for webapp | -| HotSpot | Jvaubourg |
    | https://github.com/labriqueinternet/hotspot_ynh | Wifi Hotspot for [the Brick](/install_brick) | +| HotSpot | Jvaubourg |
    | https://github.com/labriqueinternet/hotspot_ynh | Wifi Hotspot for [The Internet Cube](/installation_brique_fr) | | [HTML Tools](http://lehollandaisvolant.net/tout/tools/)| IsserTerrus |
    | https://github.com/isserterrus/htmltools_ynh | HTML Mini-tools | | [HTPC Manager](http://htpc.io) | lunarok |
    | https://github.com/lunarok/htpc_ynh | Manage your HTPC | | [I Hate Money](http://ihatemoney.org/) | JocelynD |
    | https://github.com/JocelynDelalande/ihatemoney_ynh | A simple shared budget manager web application | @@ -81,7 +81,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [phpBB](http://www.phpbb.com/) | polytan02 |
    | https://github.com/polytan02/phpBB_ynh | #1 forum in php with adaptive design - Requires manual configuration after initial installation | | [phpLDAPadmin](http://phpldapadmin.sourceforge.net/) | aymhce |
    | https://github.com/aymhce/phpldapadmin_ynh | LDAP database web manager | | [PHPSysinfo](https://phpsysinfo.github.io/phpsysinfo/) | lunarok |
    | https://github.com/lunarok/phpsysinfo_ynh | Informations about your system | -| [PirateBox](https://github.com/jvaubourg/php-piratebox) | Jvaubourg |
    | https://github.com/labriqueinternet/piratebox_ynh | PirateBox for [the Brick](/install_brick) | +| [PirateBox](https://github.com/jvaubourg/php-piratebox) | Jvaubourg |
    | https://github.com/labriqueinternet/piratebox_ynh | PirateBox for [The Internet Cube](/installation_brique_fr) | | [Piwigo](http://piwigo.org) | monsieur-a |
    | https://github.com/monsieur-a/piwigo_ynh | Web photo gallery | | [Piwik](http://piwik.org) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/piwik_ynh | Web analytics platform | | [Plexmediaserver](https://plex.tv/) | Chao-Man |
    | https://github.com/Novakin/plexmediaserver_ynh | PlexMediaServer | @@ -102,10 +102,10 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Syncthing](https://syncthing.net/) | tuxmouraille |
    | https://github.com/tuxmouraille/syncthing_ynh | Sync and encrypted service | | [TagSpaces](http://www.tagspaces.org/) | scith |
    | https://github.com/scith/tagspaces_ynh | Manage files using tags | | [Telegram](http://www.telegram.org/) | Cyp |
    | https://github.com/magikcypress/telegram_ynh | a new era of messaging | -| Tor Client | Bleuchtang |
    | https://github.com/labriqueinternet/torclient_ynh| Tor Client for [the Brick](/install_brick) | +| Tor Client | Bleuchtang |
    | https://github.com/labriqueinternet/torclient_ynh| Tor Client for [The Internet Cube](/installation_brique_fr) | | [Tor Relay](https://www.torproject.org/docs/tor-doc-relay.html.en) | matlink |
    | https://github.com/matlink/torrelay_ynh | Tor node | | [uCoin](http://ucoin.io/) | Moul |
    | https://github.com/ucoin-io/ucoin_ynh | uCoin node:
    free monetary system | -| VPN Client | Jvaubourg |
    | https://github.com/labriqueinternet/vpnclient_ynh | VPN Client for [the Brick](/install_brick) | +| VPN Client | Jvaubourg |
    | https://github.com/labriqueinternet/vpnclient_ynh | VPN Client for [The Internet Cube](/installation_brique_fr) | | [Webapp Multi](https://github.com/polytan02/webapp_multi_ynh) | polytan02 |
    | https://github.com/polytan02/webapp_multi_ynh | Multi instances & multi domains web app without FTP support | | [Webmin](http://webmin.com) | tifred |
    | https://github.com/drfred1981/webmin_ynh | Web-based system configuration tool | | [Wordpress multisite](http://codex.wordpress.org/Create_A_Network) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/wordpress_ynh | Wordpress with network support | From e6766f527a279b3741f0f695e410b996b1879ce9 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sun, 9 Aug 2015 13:00:42 +0200 Subject: [PATCH 101/229] Update installation_brique_fr.md --- installation_brique_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index 03b66463..04d8cb6e 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -1,7 +1,7 @@ # Installation d’une Brique Internet
    -Site du projet **La Brique Internet**: http://labriqueinter.net/ +Site du projet **La Brique Internet** : http://labriqueinter.net/
    *Instructions basées sur l'image **[labriqueinternet_04-06-2015_jessie.img](http://repo.labriqueinter.net/labriqueinternet_04-06-2015_jessie.img.tar.xz)** et écrites début Juillet par kload chez **Neutrinet**.* From b78e59fa9ce0e8f1b15ae98596d4f59dd4d79ada Mon Sep 17 00:00:00 2001 From: "valentin@grimaud.me" Date: Mon, 10 Aug 2015 00:57:11 +0200 Subject: [PATCH 102/229] Update packaging_apps_fr.md --- packaging_apps_fr.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/packaging_apps_fr.md b/packaging_apps_fr.md index a02f8771..5e3cc152 100644 --- a/packaging_apps_fr.md +++ b/packaging_apps_fr.md @@ -233,4 +233,6 @@ yunohost app install https://github.com/auteur/mon_paquet.git * [Ajoutez](/write_documentation_fr) votre application à [la liste des apps non officielles](https://yunohost.org/#/apps_in_progress_en) avec l’état du paquet : `Ready`, `In progress` ou `Not working`. ### Officialisation d’une application -Pour qu’une application deviennent officielle, elle doit être suffisament testé, stable et fonctionner sous les architectures de processeurs 64 bits, 32 bits et ARM. Si ces conditions vous paraissent réuni, demandez l’[intégration officielle](http://app.yunohost.org) de votre application. \ No newline at end of file +Pour qu’une application deviennent officielle, elle doit être suffisament testé, stable et fonctionner sous les architectures de processeurs 64 bits, 32 bits et ARM. Si ces conditions vous paraissent réuni, demandez l’[intégration officielle](http://app.yunohost.org) de votre application. + +L'application doit aussi fonctionner sur yunohost wheezy et jessie. \ No newline at end of file From d2f87ec602803199f8e4d9058418265fd2500170 Mon Sep 17 00:00:00 2001 From: "valentin@grimaud.me" Date: Mon, 10 Aug 2015 01:11:35 +0200 Subject: [PATCH 103/229] Update packaging_apps_fr.md --- packaging_apps_fr.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/packaging_apps_fr.md b/packaging_apps_fr.md index 5e3cc152..b791ac38 100644 --- a/packaging_apps_fr.md +++ b/packaging_apps_fr.md @@ -227,6 +227,17 @@ Remarque : ça fonctionne aussi avec une URL Git : ```bash yunohost app install https://github.com/auteur/mon_paquet.git ``` + +### Améliorer la qualité du paquet d'installation +Vous trouverez ci-dessous une liste de point à vérifier concernant la qualité de vos scripts: +* Vos scripts utilisent bien `sudo cp -a ../sources/. $final_path` plutôt que `sudo cp -a ../sources/* $final_path` +* Votre script d'installation contient une gestion en cas d'erreurs du script pour supprimer les fichiers résiduels à l'aide de `set -e` et de `trap` +* Votre script d'installation utilise une méthode d'installation en ligne de commande plutôt qu'un appel curl à un formulaire web d'installation +* Votre script d'installation enregistre les réponses de l'utilisateur +* Vous avez vérifié les sources de l'application avec une somme de contrôle (sha256, sha1 ou md5) ou une signature PGP +* Vos scripts ont été testé sur wheezy, jessie, 32 bits, 64 bits, ARM +* Les scripts backup et restore sont présents et fonctionnels + ### Publiez et demandez des tests de votre application * Demandez des tests et des retours sur votre application en publiant un [post sur le Forum](https://forum.yunohost.org/) avec la catégorie `App integration`. From 5906c8993cd0c35df605c68092b43248a7cf63cd Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Mon, 10 Aug 2015 17:47:45 +0200 Subject: [PATCH 104/229] Update packaging_apps_fr.md --- packaging_apps_fr.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/packaging_apps_fr.md b/packaging_apps_fr.md index b791ac38..bfa08d3e 100644 --- a/packaging_apps_fr.md +++ b/packaging_apps_fr.md @@ -244,6 +244,4 @@ Vous trouverez ci-dessous une liste de point à vérifier concernant la qualité * [Ajoutez](/write_documentation_fr) votre application à [la liste des apps non officielles](https://yunohost.org/#/apps_in_progress_en) avec l’état du paquet : `Ready`, `In progress` ou `Not working`. ### Officialisation d’une application -Pour qu’une application deviennent officielle, elle doit être suffisament testé, stable et fonctionner sous les architectures de processeurs 64 bits, 32 bits et ARM. Si ces conditions vous paraissent réuni, demandez l’[intégration officielle](http://app.yunohost.org) de votre application. - -L'application doit aussi fonctionner sur yunohost wheezy et jessie. \ No newline at end of file +Pour qu’une application deviennent officielle, elle doit être suffisament testé, stable et fonctionner sous les architectures de processeurs 64 bits, 32 bits et ARM sur Debian Wheezy et Jessie. Si ces conditions vous paraissent réuni, demandez l’[intégration officielle](http://app.yunohost.org) de votre application. \ No newline at end of file From 2caed69c7f6e221b966a645b9778484cb42a8bc2 Mon Sep 17 00:00:00 2001 From: "kload@kload.fr" Date: Mon, 10 Aug 2015 17:50:11 +0200 Subject: [PATCH 105/229] Update packaging_apps_fr.md --- packaging_apps_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packaging_apps_fr.md b/packaging_apps_fr.md index bfa08d3e..b94077f1 100644 --- a/packaging_apps_fr.md +++ b/packaging_apps_fr.md @@ -244,4 +244,4 @@ Vous trouverez ci-dessous une liste de point à vérifier concernant la qualité * [Ajoutez](/write_documentation_fr) votre application à [la liste des apps non officielles](https://yunohost.org/#/apps_in_progress_en) avec l’état du paquet : `Ready`, `In progress` ou `Not working`. ### Officialisation d’une application -Pour qu’une application deviennent officielle, elle doit être suffisament testé, stable et fonctionner sous les architectures de processeurs 64 bits, 32 bits et ARM sur Debian Wheezy et Jessie. Si ces conditions vous paraissent réuni, demandez l’[intégration officielle](http://app.yunohost.org) de votre application. \ No newline at end of file +Pour qu’une application devienne officielle, elle doit être suffisamment testée, stable et fonctionner sous les architectures 64 bits, 32 bits et ARM sur Debian Wheezy et Jessie. Si ces conditions vous paraissent réunies, demandez l’[intégration officielle](http://app.yunohost.org) de votre application. \ No newline at end of file From 68024c7ef7e54bfb14e0b4f7b6184458022d2467 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Mon, 10 Aug 2015 17:57:03 +0200 Subject: [PATCH 106/229] Update packaging_apps_fr.md --- packaging_apps_fr.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/packaging_apps_fr.md b/packaging_apps_fr.md index b94077f1..4a33d382 100644 --- a/packaging_apps_fr.md +++ b/packaging_apps_fr.md @@ -228,15 +228,15 @@ Remarque : ça fonctionne aussi avec une URL Git : yunohost app install https://github.com/auteur/mon_paquet.git ``` -### Améliorer la qualité du paquet d'installation -Vous trouverez ci-dessous une liste de point à vérifier concernant la qualité de vos scripts: -* Vos scripts utilisent bien `sudo cp -a ../sources/. $final_path` plutôt que `sudo cp -a ../sources/* $final_path` -* Votre script d'installation contient une gestion en cas d'erreurs du script pour supprimer les fichiers résiduels à l'aide de `set -e` et de `trap` -* Votre script d'installation utilise une méthode d'installation en ligne de commande plutôt qu'un appel curl à un formulaire web d'installation -* Votre script d'installation enregistre les réponses de l'utilisateur -* Vous avez vérifié les sources de l'application avec une somme de contrôle (sha256, sha1 ou md5) ou une signature PGP -* Vos scripts ont été testé sur wheezy, jessie, 32 bits, 64 bits, ARM -* Les scripts backup et restore sont présents et fonctionnels +### Améliorer la qualité du paquet d’installation +Vous trouverez ci-dessous une liste des point à vérifier concernant la qualité de vos scripts : +* Vos scripts utilisent bien `sudo cp -a ../sources/. $final_path` plutôt que `sudo cp -a ../sources/* $final_path` ; +* Votre script d’installation contient une gestion en cas d’erreurs du script pour supprimer les fichiers résiduels à l'aide de `set -e` et de `trap` ; +* Votre script d’installation utilise une méthode d’installation en ligne de commande plutôt qu'un appel curl via un formulaire web d’installation ; +* Votre script d’installation enregistre les réponses de l'utilisateur ; +* Vous avez vérifié les sources de l’application avec une somme de contrôle (sha256, sha1 ou md5) ou une signature PGP ; +* Vos scripts ont été testé sur Debian Wheezy et Jessie ainsi que sur les architectures 32 bits, 64 bits et ARM ; +* Les scripts backup et restore sont présents et fonctionnels. ### Publiez et demandez des tests de votre application * Demandez des tests et des retours sur votre application en publiant un [post sur le Forum](https://forum.yunohost.org/) avec la catégorie `App integration`. From 8985e7a0a8913edc837a8498870337a12201f829 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Mon, 10 Aug 2015 18:46:45 +0200 Subject: [PATCH 107/229] Update packaging_apps.md --- packaging_apps.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/packaging_apps.md b/packaging_apps.md index 679df6d1..16962ae6 100644 --- a/packaging_apps.md +++ b/packaging_apps.md @@ -228,10 +228,21 @@ Note that it also works with a Git URL: ```bash yunohost app install https://github.com/author/my_app_package.git ``` + +### Enhance package +You will find points to verify quality of your scripts: +* scripts should use `sudo cp -a ../sources/. $final_path` instead of `sudo cp -a ../sources/* $final_path`; +* install script must contain support in case of script errors to delete residuals files thanks to `set -e` and `trap`; +* install script should use command line method instead of curl call through web install form; +* install script should save install answers; +* application sources should be checked with a control sum (sha256, sha1 or md5) or a PGP signature; +* scripts had been tested on Debian Wheezy and Jessie as well as 32 bits, 64 bits and ARM architectures; +* backup and restore scripts are present and functional. + ### Publish and ask for testing your application * Publishing a [post on the Forum](https://forum.yunohost.org/) with the `App integration` category, to ask tests and returns on your application. * [Add](/write_documentation_en) your application to the [non-officials list of application](https://yunohost.org/#/apps_in_progress_en) with the state of the package: `Ready`, `In progress` or `Not working`. ### Officalization of an application -To become an official application, it must be enough tested, stable and should works on 64 bits, 32 bits et ARM processors architectures. If you think thoses conditions are gather, ask for [official integration](http://app.yunohost.org) of your application. \ No newline at end of file +To become an official application, it must be enough tested, stable and should works on 64 bits, 32 bits et ARM processors architectures and on Debian Wheezy and Jessie. If you think thoses conditions are gather, ask for [official integration](http://app.yunohost.org) of your application. \ No newline at end of file From 68d5afed0a3fc998edb7dc33464e4ef1f28a8bcf Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Mon, 10 Aug 2015 22:09:00 +0200 Subject: [PATCH 108/229] Update apps_in_progress.md --- apps_in_progress.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apps_in_progress.md b/apps_in_progress.md index d3875f53..a9428721 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -3,7 +3,6 @@ Official apps Apps in progress Apps wishlist The following applications are being packaged on by a growing number of packagers. -
    These applications are **NOT** validated by the packaging team, and as such, **no official support is provided** for them.
    You can test and use them, **at your own risk**.
    @@ -91,6 +90,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Pydio](http://pyd.io) | ju |
    | https://github.com/julienmalik/pydio_ynh | File sharing and synchronization | | [Radicale](http://radicale.org/) | beudbeud |
    | https://github.com/abeudin/radicale_ynh | Caldav & Carddav Server | | [Rainloop](http://rainloop.net/) | polytan02 |
    | https://github.com/polytan02/rainloop_ynh | Rainloop : nice and simple webmail - configuration by hand | +| [Rainloop](http://rainloop.net/) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/rainloop_ynh | Rainloop : nice and simple webmail - [For advanced users](https://github.com/maniackcrudelis/rainloop_ynh/blob/master/README.md) | | [Red Matrix](https://redmatrix.me/) | anaqreon |
    | https://github.com/anaqreon/redmatrix_ynh | Social network and decentralized identity platform | | [Sabnzbd](http://http://sabnzbd.org/) | Chao-Man |
    | https://github.com/Chao-Man/sabnzbd_ynh | Automated Usenet download | | [SCM-Manager](https://www.scm-manager.org/) | tifred |
    | https://github.com/drfred1981/scm-manager_ynh | Share and manage repositories over HTTP | From a849c27fc80e6134019513344296203c7855efc8 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Tue, 18 Aug 2015 21:35:13 +0200 Subject: [PATCH 109/229] Update apps_in_progress.md --- apps_in_progress.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/apps_in_progress.md b/apps_in_progress.md index a9428721..01f2500e 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -32,6 +32,9 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Cubiks-2048](https://kshitij-banerjee.github.io/Cubiks-2048/) | Moul |
    | https://github.com/M5oul/Cubiks-2048_ynh | Clone of 2048 game in 3D | | Custom Webapp (Multi instance) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/my_webapp_ynh |Custom Webapp | | [Diaspora](http://diasporafoundation.org) | aymhce |
    | https://github.com/aymhce/diaspora_ynh | Distributed social networking service | +| [Docker Container](https://registry.hub.docker.com/search?q=library) | scith |
    | https://github.com/scith/docker_container_ynh | Docker allows to deploy applications which have not yet been integrated with YunoHost (use with redirect_ynh) | +| [Docker RStudio](https://www.rstudio.com/) | scith |
    | https://github.com/scith/docker_rstudio_ynh | RStudio is a web development environment for R (statistics). This app runs through Docker | +| [DockerUI](https://registry.hub.docker.com/search?q=library) | scith |
    | https://github.com/scith/dockerui_ynh | DockerUI is a web interface to manage Docker containers and images | | [EmailPoubelle](http://forge.zici.fr/p/emailpoubelle-php/) | matlink |
    | https://github.com/matlink/emailpoubelle_ynh | Disposable email | | [EtherCalc](https://ethercalc.org/) | zamentur |
    | https://github.com/zamentur/ethercalc_ynh | Web spreadsheet | | [Etherpad-Lite](http://etherpad.org) | beudbeud |
    | https://github.com/abeudin/etherpadlite_ynh | Real-time collaborative document editing | @@ -67,10 +70,11 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [MediaWiki](https://mediawiki.org) | ElieSauveterre |
    | https://github.com/mikangali-labs/mediawiki_ynh | Wiki platform | | [minchat](https://github.com/chtixof/minchat_ynh) | chtixof |
    | https://github.com/chtixof/minchat_ynh | Minimalist web chat | | [miniflux](http://miniflux.net) | matanya |
    | https://github.com/mat-mo/miniflux_ynh | RSS reader via RTL support | +| [Monit](http://mmonit.com/monit/) | ju |
    | https://github.com/julienmalik/monit_ynh | Daemon Monitoring tool | +| [Movim](https://movim.eu) | src386_ |
    | https://github.com/src386/movim_ynh | Kick Ass Social Network | | [Mumble Admin Plugin](http://wiki.mumble.info/wiki/MAP_-_Mumb1e_Admin_Plugin) | matlink |
    | https://github.com/matlink/mumble_admin_plugin_ynh | Web interface to manage mumble server | | [Mumble Server](http://wiki.mumble.info/wiki/Main_Page) | matlink |
    | https://github.com/matlink/mumbleserver_ynh | Voice chat for gaming and meeting | | [Munin](http://munin-monitoring.org/) | ju |
    | https://github.com/julienmalik/munin_ynh | System Monitoring graphing tool | -| [Monit](http://mmonit.com/monit/) | ju |
    | https://github.com/julienmalik/monit_ynh | Daemon Monitoring tool | | [MyCryptoChat](https://github.com/HowTommy/mycryptochat) | mrtino |
    | https://github.com/mrtino/mycryptochat_ynh | Encrypted chat rooms manager | | [Odoo](https://www.odoo.com/) | portanicolas |
    | https://github.com/portanicolas/odoov8_ynh | ERP | | [OFBiz](https://ofbiz.apache.org/) | julien |
    | https://github.com/nomakaFr/ofbiz_ynh | ERP | @@ -82,7 +86,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [PHPSysinfo](https://phpsysinfo.github.io/phpsysinfo/) | lunarok |
    | https://github.com/lunarok/phpsysinfo_ynh | Informations about your system | | [PirateBox](https://github.com/jvaubourg/php-piratebox) | Jvaubourg |
    | https://github.com/labriqueinternet/piratebox_ynh | PirateBox for [The Internet Cube](/installation_brique_fr) | | [Piwigo](http://piwigo.org) | monsieur-a |
    | https://github.com/monsieur-a/piwigo_ynh | Web photo gallery | -| [Piwik](http://piwik.org) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/piwik_ynh | Web analytics platform | +| [Piwik](http://piwik.org) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/piwik_ynh_2 | Web analytics platform | | [Plexmediaserver](https://plex.tv/) | Chao-Man |
    | https://github.com/Novakin/plexmediaserver_ynh | PlexMediaServer | | [PluXml](http://www.pluxml.org/) | matlink |
    | https://github.com/matlink/pluxml_ynh | Blogging platform | | [proFTPd](http://www.proftpd.org/) | beudbeud |
    | https://github.com/abeudin/proftpd_ynh | FTP server | @@ -92,6 +96,8 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Rainloop](http://rainloop.net/) | polytan02 |
    | https://github.com/polytan02/rainloop_ynh | Rainloop : nice and simple webmail - configuration by hand | | [Rainloop](http://rainloop.net/) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/rainloop_ynh | Rainloop : nice and simple webmail - [For advanced users](https://github.com/maniackcrudelis/rainloop_ynh/blob/master/README.md) | | [Red Matrix](https://redmatrix.me/) | anaqreon |
    | https://github.com/anaqreon/redmatrix_ynh | Social network and decentralized identity platform | +| [Redirect](https://github.com/scith/redirect_ynh) | scith |
    | https://github.com/scith/redirect_ynh | This app allows to create a YunoHost application redirecting to one port and/or path | +| [ruTorrent](https://github.com/Novik/ruTorrent) | CotzaDev |
    | https://github.com/CotzaDev/rutorrent_ynh | A front-end for the popular BitTorrent client rtorrent | | [Sabnzbd](http://http://sabnzbd.org/) | Chao-Man |
    | https://github.com/Chao-Man/sabnzbd_ynh | Automated Usenet download | | [SCM-Manager](https://www.scm-manager.org/) | tifred |
    | https://github.com/drfred1981/scm-manager_ynh | Share and manage repositories over HTTP | | [Seafile](http://seafile.com/) | CotzaDev

    mbugeia |
    | https://github.com/CotzaDev/seafile_ynh
    https://github.com/mbugeia/seafile_ynh | Cloud storage service with encryption | From ee8aff398213d5244e82953ff4e859a38df9fd91 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Tue, 18 Aug 2015 21:37:55 +0200 Subject: [PATCH 110/229] Update apps_wishlist.md --- apps_wishlist.md | 1 + 1 file changed, 1 insertion(+) diff --git a/apps_wishlist.md b/apps_wishlist.md index 57f7dfbb..6d962001 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -94,5 +94,6 @@ The following list is a compiled wishlist of applications that would be nice-to- * [webSync](http://furier.github.io/websync/) * [WebTorrent](https://github.com/feross/webtorrent) * [Wisemapping](http://www.wisemapping.com/) +* [YellowCMS](http://datenstrom.se/yellow/) * [Zone-project](https://github.com/descl/ZONE) * [ZNC](http://wiki.znc.in/ZNC) From 4c3e07adacbced82cb8edb22db911bbf94855b99 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Tue, 18 Aug 2015 21:39:18 +0200 Subject: [PATCH 111/229] Update installation_brique_fr.md --- installation_brique_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index 04d8cb6e..78329cce 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -81,7 +81,7 @@ Ajouter à la fin du fichier : 192.168.4.2 michu.nohost.me ``` -3. Procéder à la [postinstallation](/postinstallation_fr) en se connectant à la Brique sur https://michu.nohost.me. L’uilisateur pourra lui-même saisir le mot de passe d’administration qu'il souhaite lors de cette étape. +3. Procéder à la [postinstallation](/postinstall_fr) en se connectant à la Brique sur https://michu.nohost.me. L’uilisateur pourra lui-même saisir le mot de passe d’administration qu'il souhaite lors de cette étape.
    **Note :** il est possible de réaliser cette étape en ligne de commande via SSH en exécutant `yunohost tools postinstall`
    From 65032f5a84a936888ea9646dfd3143f705da4b2d Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 19 Aug 2015 14:04:28 +0200 Subject: [PATCH 112/229] Update apps_wishlist.md --- apps_wishlist.md | 1 - 1 file changed, 1 deletion(-) diff --git a/apps_wishlist.md b/apps_wishlist.md index 6d962001..003ea16b 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -54,7 +54,6 @@ The following list is a compiled wishlist of applications that would be nice-to- * [Mirakel](http://mirakel.azapps.de/taskwarrior.html) * [Modoboa](http://modoboa.org/) * [Mopidy](https://www.mopidy.com/) -* [Movim](http://www.movim.eu/) * [Nibbleblog](http://www.nibbleblog.com) * [Only Office](http://onlyoffice.org/) * [Paperwork](http://paperwork.rocks) From 7b4623615a5813ad9454ca9088e7a7a56eecc50e Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 19 Aug 2015 14:08:14 +0200 Subject: [PATCH 113/229] Update apps_in_progress.md --- apps_in_progress.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/apps_in_progress.md b/apps_in_progress.md index 01f2500e..17def8ad 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -33,7 +33,6 @@ The packagers will appreciate your remarks. If you test them and find issues, or | Custom Webapp (Multi instance) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/my_webapp_ynh |Custom Webapp | | [Diaspora](http://diasporafoundation.org) | aymhce |
    | https://github.com/aymhce/diaspora_ynh | Distributed social networking service | | [Docker Container](https://registry.hub.docker.com/search?q=library) | scith |
    | https://github.com/scith/docker_container_ynh | Docker allows to deploy applications which have not yet been integrated with YunoHost (use with redirect_ynh) | -| [Docker RStudio](https://www.rstudio.com/) | scith |
    | https://github.com/scith/docker_rstudio_ynh | RStudio is a web development environment for R (statistics). This app runs through Docker | | [DockerUI](https://registry.hub.docker.com/search?q=library) | scith |
    | https://github.com/scith/dockerui_ynh | DockerUI is a web interface to manage Docker containers and images | | [EmailPoubelle](http://forge.zici.fr/p/emailpoubelle-php/) | matlink |
    | https://github.com/matlink/emailpoubelle_ynh | Disposable email | | [EtherCalc](https://ethercalc.org/) | zamentur |
    | https://github.com/zamentur/ethercalc_ynh | Web spreadsheet | @@ -76,7 +75,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Mumble Server](http://wiki.mumble.info/wiki/Main_Page) | matlink |
    | https://github.com/matlink/mumbleserver_ynh | Voice chat for gaming and meeting | | [Munin](http://munin-monitoring.org/) | ju |
    | https://github.com/julienmalik/munin_ynh | System Monitoring graphing tool | | [MyCryptoChat](https://github.com/HowTommy/mycryptochat) | mrtino |
    | https://github.com/mrtino/mycryptochat_ynh | Encrypted chat rooms manager | -| [Odoo](https://www.odoo.com/) | portanicolas |
    | https://github.com/portanicolas/odoov8_ynh | ERP | +| [Odoo (Dockerized)](https://www.odoo.com) | scith |
    | https://github.com/scith/docker_odoo_ynh | Odoo is a suite of business apps (ERP: CRM, Accounting, Point of Sale, HR, Purchases...). | | [OFBiz](https://ofbiz.apache.org/) | julien |
    | https://github.com/nomakaFr/ofbiz_ynh | ERP | | [OpenDKIM](http://opendkim.org/) | polytan02 |
    | https://github.com/polytan02/opendkim_ynh | OpenDKIM for Yunohost installation script | | [OpenID](http://openid.net/) | ju |
    | https://github.com/julienmalik/openid-simplesamlphp_ynh | OpenID Identity server | @@ -97,6 +96,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Rainloop](http://rainloop.net/) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/rainloop_ynh | Rainloop : nice and simple webmail - [For advanced users](https://github.com/maniackcrudelis/rainloop_ynh/blob/master/README.md) | | [Red Matrix](https://redmatrix.me/) | anaqreon |
    | https://github.com/anaqreon/redmatrix_ynh | Social network and decentralized identity platform | | [Redirect](https://github.com/scith/redirect_ynh) | scith |
    | https://github.com/scith/redirect_ynh | This app allows to create a YunoHost application redirecting to one port and/or path | +| [RStudio (Dockerized)](https://www.rstudio.com/) | scith |
    | https://github.com/scith/docker_rstudio_ynh | RStudio is a web development environment for R (statistics). This app runs through Docker | | [ruTorrent](https://github.com/Novik/ruTorrent) | CotzaDev |
    | https://github.com/CotzaDev/rutorrent_ynh | A front-end for the popular BitTorrent client rtorrent | | [Sabnzbd](http://http://sabnzbd.org/) | Chao-Man |
    | https://github.com/Chao-Man/sabnzbd_ynh | Automated Usenet download | | [SCM-Manager](https://www.scm-manager.org/) | tifred |
    | https://github.com/drfred1981/scm-manager_ynh | Share and manage repositories over HTTP | @@ -119,7 +119,6 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Yourls](http://yourls.org/) | courgette |
    | https://github.com/courgette/yourls_ynh | URL Shortening service | | Yunofav | chtixof |
    | https://github.com/chtixof/yunofav | Page of favorite links Yunohost-styled | | [Zomburl](http://cadav.re/) | courgette |
    | https://github.com/courgette/zomburl_ynh | URL Shortening service | -| [ZoteroSync](http://blog.holz.ca/2011/11/phpzoterowebdav-installation/) | scith |
    | https://github.com/scith/zoterosync_ynh | Sync Zotero library and files | | [Z-Push](https://z-push.org/) | beudbeud |
    | https://github.com/abeudin/z-push_ynh | ActiveSync Server | \ No newline at end of file + From c877b0df0fad8dcc0cd96cfa06147befae0c85d1 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Mon, 24 Aug 2015 14:42:00 +0200 Subject: [PATCH 119/229] Update apps_wishlist.md --- apps_wishlist.md | 1 + 1 file changed, 1 insertion(+) diff --git a/apps_wishlist.md b/apps_wishlist.md index c932133d..2f5c7b1b 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -95,5 +95,6 @@ The following list is a compiled wishlist of applications that would be nice-to- * [WebTorrent](https://github.com/feross/webtorrent) * [Wisemapping](http://www.wisemapping.com/) * [YellowCMS](http://datenstrom.se/yellow/) +* [Yify-pop](https://github.com/yify-pop/yify-pop) * [Zone-project](https://github.com/descl/ZONE) * [ZNC](http://wiki.znc.in/ZNC) From da7f3267d3743ab85aea9c69efa4fca5779eca06 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 26 Aug 2015 16:12:47 +0200 Subject: [PATCH 120/229] Update apps_wishlist.md --- apps_wishlist.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apps_wishlist.md b/apps_wishlist.md index 2f5c7b1b..3e350dc2 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -65,6 +65,7 @@ The following list is a compiled wishlist of applications that would be nice-to- * [Pico](http://picocms.org/) * [Pix](http://pix.toile-libre.org/) * [PPTP VPN](https://packages.debian.org/sv/squeeze/pptpd) +* [Protonmail](https://protonmail.ch/) * [Pulse](https://ind.ie/pulse/) * [Pump.io](http://pump.io) * [racktables](http://racktables.org/) @@ -95,6 +96,5 @@ The following list is a compiled wishlist of applications that would be nice-to- * [WebTorrent](https://github.com/feross/webtorrent) * [Wisemapping](http://www.wisemapping.com/) * [YellowCMS](http://datenstrom.se/yellow/) -* [Yify-pop](https://github.com/yify-pop/yify-pop) * [Zone-project](https://github.com/descl/ZONE) * [ZNC](http://wiki.znc.in/ZNC) From a43fdb8ffa0e265cd25acf67cbc903190a0a35ea Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Wed, 26 Aug 2015 16:13:44 +0200 Subject: [PATCH 121/229] Update apps_in_progress.md --- apps_in_progress.md | 1 + 1 file changed, 1 insertion(+) diff --git a/apps_in_progress.md b/apps_in_progress.md index 4927730f..3310c054 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -116,6 +116,7 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [Webapp Multi](https://github.com/polytan02/webapp_multi_ynh) | polytan02 |
    | https://github.com/polytan02/webapp_multi_ynh | Multi instances & multi domains web app without FTP support | | [Webmin](http://webmin.com) | tifred |
    | https://github.com/drfred1981/webmin_ynh | Web-based system configuration tool | | [Wordpress multisite](http://codex.wordpress.org/Create_A_Network) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/wordpress_ynh | Wordpress with network support | +| [Yify-pop](https://github.com/yify-pop/yify-pop) | m0dm |
    | https://github.com/M0dM/yify-pop_ynh | Inspired by Popcorn Time, a node web server to stream torrents from YIFY. | | [YaCy](http://yacy.net) | Moul |
    | https://github.com/M5oul/yacy_ynh/ | Libre and decentralized search engine | | [Yourls](http://yourls.org/) | courgette |
    | https://github.com/courgette/yourls_ynh | URL Shortening service | | Yunofav | chtixof |
    | https://github.com/chtixof/yunofav | Page of favorite links Yunohost-styled | From e9e097673527119d25d390f8df60e7957543fd97 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Sat, 29 Aug 2015 15:26:13 +0200 Subject: [PATCH 122/229] Update apps_wishlist.md --- apps_wishlist.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/apps_wishlist.md b/apps_wishlist.md index 3e350dc2..c6a24a1b 100644 --- a/apps_wishlist.md +++ b/apps_wishlist.md @@ -49,12 +49,13 @@ The following list is a compiled wishlist of applications that would be nice-to- * [MaidSafe](http://maidsafe.net/) * [Mailman](https://www.gnu.org/software/mailman/) * [Mailpile](https://www.mailpile.is) -* [MPD](http://www.musicpd.org/) * [MediaCrush](https://imgrush.com/) +* [Mini Jappix](https://github.com/jappix/jappix/wiki/JappixMini) * [MinigalNano](https://github.com/sebsauvage/MinigalNano) * [Mirakel](http://mirakel.azapps.de/taskwarrior.html) * [Modoboa](http://modoboa.org/) * [Mopidy](https://www.mopidy.com/) +* [MPD](http://www.musicpd.org/) * [Nibbleblog](http://www.nibbleblog.com) * [Only Office](http://onlyoffice.org/) * [Paperwork](http://paperwork.rocks) From 5abcad5f2fa08c14c63173ad7bf8d7df280c89b9 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Fri, 4 Sep 2015 17:39:04 +0200 Subject: [PATCH 123/229] Update installation_brique_fr.md --- installation_brique_fr.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/installation_brique_fr.md b/installation_brique_fr.md index 0ff996bb..fee1b167 100644 --- a/installation_brique_fr.md +++ b/installation_brique_fr.md @@ -56,7 +56,7 @@ Admettons que l’adresse IP locale de la Brique soit **192.168.4.2** ```bash ssh root@192.168.4.2 ``` -7. Mettre à jour le système (environ 10 minutes), et pré-installer les paquets qui seront nécessaires aux applications **vpnclient** et **hotspot** (comme ça c'est fait). +7. Mettre à jour le système (environ 10 minutes), et pré-installer les paquets qui seront nécessaires aux applications **vpnclient** et **hotspot**. Cette pré-installation n'est pas du tout indispensable puisque si ces éléments n'étaient pas présents, YunoHost les installerait au moment de l'installation des applications. ```bash apt-get update && apt-get upgrade apt-get install openvpn sipcalc hostapd iw dnsmasq firmware-linux-free firmware-linux-nonfree firmware-realtek firmware-ralink @@ -92,7 +92,7 @@ ssh root@michu.nohost.me passwd root ``` -5. **Solution temporaire** : la création des répertoires utilisateur ne se fait pas automatiquement dans cette image YunoHost pour la Brique. Il convient donc d'ajouter un script qui s'exécutera à la création des utilisateurs YunoHost et qui s’en assurera. +5. **Solution temporaire** : la création des répertoires utilisateur ne se fait pas automatiquement dans cette image YunoHost pour la Brique. Il convient donc d'ajouter un script qui s'exécutera à la création des utilisateurs YunoHost et qui s’en assurera. En SSH sur la Brique : ```bash mkdir -p /usr/share/yunohost/hooks/post_user_create @@ -127,7 +127,7 @@ topology subnet **Attention** : le redémarrage du service, déclenché par le bouton **Save and reload**, peut mettre quelques minutes.
    -10. **Installer l’application Hotspot** : s'assurer que l’antenne WiFi est bien branchée, et répéter les étapes **7**, **8** et **9** en installant à l’aide de l'URL `https://github.com/labriqueinternet/hotspot_ynh` +10. **Installer l’application Hotspot** : s'assurer que l’antenne WiFi est bien branchée, et répéter les étapes **7**, **8** et **9** en installant à l’aide de l'URL `https://github.com/labriqueinternet/hotspot_ynh` @@ -194,11 +194,11 @@ Une fois le fichier éditer, redémarrer le service postfix : systemctl restart postfix ``` -* **Mettre à jour la configuration SSH** : par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_confg` et de remplacer passer **PermitRootLogin** à **without-password**. +* **Mettre à jour la configuration SSH** : par défaut, la connexion en tant que **root** est possible sur la Brique. Pour ne garder que la connexion en tant qu’**admin** (qui est sudoer), il convient d’éditer le `/etc/ssh/sshd_config` et de remplacer passer **PermitRootLogin** à **without-password**. * **Configurer le reverse DNS** : pour s’assurer du bon fonctionnement du serveur email, il est recommandé de configurer un reverse DNS pour son IP. En tant que FAI associatif, c’est un service faisable, autant en profiter ! -* **Configurer le DKIM** : avec un SPF et un PTR bien configuré dans les DNS, les emails envoyés par la Brique ne devrait pas être considérés comme spam. Ceci dit, GMail et d’autres dégraderont considérablement le spamscore si le DKIM n’est pas configuré également. +* **Configurer le DKIM** : avec un SPF et un PTR bien configurés dans les DNS, les emails envoyés par la Brique ne devraient pas être considérés comme spam. Ceci dit, GMail et d’autres dégraderont considérablement le spamscore si le DKIM n’est pas configuré également. Cette opération est longue mais à considérer pour avoir un serveur email irréprochable en production. Plus de renseignement sur [la page de documentation appropriée](/dkim_fr). * **Installer Roundcube** via l’interface d’administration YunoHost et tester l’envoi/réception d’email. From 5fdd2a27c20d39803f4e46f9ed777b385b4d4e92 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Fri, 4 Sep 2015 17:44:26 +0200 Subject: [PATCH 124/229] Update isp_fr.md --- isp_fr.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/isp_fr.md b/isp_fr.md index a2c9d138..45675aa4 100644 --- a/isp_fr.md +++ b/isp_fr.md @@ -29,5 +29,7 @@ Pour une liste plus complète et précise, référez-vous à la très bonne docu | Fournisseur d’accès | Box/ routeur | uPnP activable | [Port 25 ouvrable](email_fr)| [Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning) | [Reverse DNS](https://en.wikipedia.org/wiki/Reverse_DNS_lookup) | IP fixe | | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | -| **Belgacom** | BBox2 | oui (activé) | oui | **non** | **non** | **non** | +| **Proximus** | BBox2 | oui (activé) | oui | **non** | **non** | **non** | +| | BBox3 | oui (activé) | oui | **non** | **non** | **non** | | **Scarlet** | BBox2 | oui (activé) | oui | **non** | **non** | **non** | +**Proximus** ne serait pas ouvert à l'auto-hébergement. L'ouverture des ports serait plus difficile afin d'éviter tout SPAM. Il serait préférable de passer par [Neutrinet](http://neutrinet.be), un des [membres de la Fédération French Data Network](http://www.ffdn.org/fr/membres). \ No newline at end of file From 6907c3f4b2249684869dc931fbfdd0dc570e153d Mon Sep 17 00:00:00 2001 From: "valentin@grimaud.me" Date: Sat, 5 Sep 2015 18:26:37 +0200 Subject: [PATCH 125/229] Update apps_in_progress.md --- apps_in_progress.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/apps_in_progress.md b/apps_in_progress.md index 3310c054..c8d5785d 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -21,8 +21,9 @@ The packagers will appreciate your remarks. If you test them and find issues, or | [20euros](https://jatekos101.github.io/20euros/) | Moul |
    | https://github.com/M5oul/20euros_ynh | Clone of 2048 game with euros | | [243](https://hgentry.github.io/81/) | Moul |
    | https://github.com/M5oul/243_ynh | Clone of 2048 game: goal reach 243 | | Ajax google apis | zamentur |
    | https://github.com/zamentur/ajaxgoogleapis_ynh | Google APIs mirror | -| [Ampache](http://ampache.org/) | beudbeud |
    | https://github.com/abeudin/ampache_ynh | Web based audio/video streaming | | [Adminer](http:/adminer.org/) | Fol |
    | https://github.com/jesuisfol/adminer_ynh | Lightweight database administration tool | +| [Ampache](http://ampache.org/) | beudbeud |
    | https://github.com/abeudin/ampache_ynh | Web based audio/video streaming | +| [AskBot](https://askbot.com/) | Zamentur |
    | https://github.com/zamentur/askbot_ynh | Question & Answer system (I don't maintain this package) | | [BTSync](http://www.getsync.com/) | tifred |
    | https://github.com/drfred1981/btsync_ynh | File synchronization tool | | [Chtickynotes](https://github.com/chtixof/chtickynotes_ynh) | chtixof |
    | https://github.com/chtixof/chtickynotes_ynh | A Post-it page | | [COPS](http://cops.com) | lunarok |
    | https://github.com/lunarok/cops_ynh | Frontend for Calibre library | From e1572de3c65a54d4639148c56eae8ae9f7401e5d Mon Sep 17 00:00:00 2001 From: Laurent Peuch Date: Tue, 8 Sep 2015 12:20:08 +0200 Subject: [PATCH 126/229] add wildcard in dns config example --- dns_config.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/dns_config.md b/dns_config.md index f2ae01d9..84228b11 100644 --- a/dns_config.md +++ b/dns_config.md @@ -5,7 +5,9 @@ Sample DNS config for domain.tld ```bash #### IPv4 & IPv6 @ 900 IN A 111.222.333.444 (Minimal) +* 900 IN A 111.222.333.444 (wildcard) @ 900 IN AAAA 2001:AABB:CCDD:EEFF:1122:3344:5566:7788 +* 900 IN AAAA 2001:AABB:CCDD:EEFF:1122:3344:5566:7788 #### Handle www subdomain www 1800 IN CNAME @ From 8ad6244bfb060c83201f1b05892afb30bcccfcbe Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Tue, 8 Sep 2015 14:58:53 +0200 Subject: [PATCH 127/229] Update dns_config_fr.md --- dns_config_fr.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/dns_config_fr.md b/dns_config_fr.md index d33912da..2499413c 100644 --- a/dns_config_fr.md +++ b/dns_config_fr.md @@ -5,7 +5,9 @@ Exemple de configuration DNS pour domain.tld ```bash #### IPv4 & IPv6 @ 900 IN A 111.222.333.444 (Minimum) +* 900 IN A 111.222.333.444 (wildcard) @ 900 IN AAAA 2001:AABB:CCDD:EEFF:1122:3344:5566:7788 +* 900 IN AAAA 2001:AABB:CCDD:EEFF:1122:3344:5566:7788 #### Gestion du sous-domaine www www 1800 IN CNAME @ From dd8bef419f3efb8dce6cd0cbac75b6ffb29411e9 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Tue, 8 Sep 2015 19:37:06 +0200 Subject: [PATCH 128/229] Update ssh_fr.md --- ssh_fr.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/ssh_fr.md b/ssh_fr.md index 61fe4394..88761b60 100644 --- a/ssh_fr.md +++ b/ssh_fr.md @@ -5,5 +5,10 @@ Le **SSH** permet de commander à distance son serveur en ligne de commande (CLI ```bash ssh admin@mon-serveur.org ``` +Ensuite, il est demandé le mot de passe administrateur, celui créé à [l’étape de post-installation](postinstall_fr). -Ensuite, il est demandé le mot de passe administrateur, celui créé à [l’étape de post-installation](postinstall_fr). \ No newline at end of file +##### Se connecter à un port différent du port par défaut 22 +Éditer la ligne `Port 22` du fichier `/etc/ssh/sshd_config`, puis connectez-vous : +```bash +ssh -p admin@mon-serveur.org +``` \ No newline at end of file From 7310297871cb9caca3e55349242b852f37208396 Mon Sep 17 00:00:00 2001 From: "ma.azimi@laposte.net" Date: Fri, 11 Sep 2015 18:03:40 +0200 Subject: [PATCH 129/229] Update apps_in_progress.md --- apps_in_progress.md | 211 ++++++++++++++++++++++---------------------- 1 file changed, 106 insertions(+), 105 deletions(-) diff --git a/apps_in_progress.md b/apps_in_progress.md index c8d5785d..7101a2b3 100644 --- a/apps_in_progress.md +++ b/apps_in_progress.md @@ -18,111 +18,112 @@ The packagers will appreciate your remarks. If you test them and find issues, or | Name | Packager | State | URL repositories | Description | --- | --- | --- | --- | --- | -| [20euros](https://jatekos101.github.io/20euros/) | Moul |
    | https://github.com/M5oul/20euros_ynh | Clone of 2048 game with euros | -| [243](https://hgentry.github.io/81/) | Moul |
    | https://github.com/M5oul/243_ynh | Clone of 2048 game: goal reach 243 | -| Ajax google apis | zamentur |
    | https://github.com/zamentur/ajaxgoogleapis_ynh | Google APIs mirror | -| [Adminer](http:/adminer.org/) | Fol |
    | https://github.com/jesuisfol/adminer_ynh | Lightweight database administration tool | -| [Ampache](http://ampache.org/) | beudbeud |
    | https://github.com/abeudin/ampache_ynh | Web based audio/video streaming | -| [AskBot](https://askbot.com/) | Zamentur |
    | https://github.com/zamentur/askbot_ynh | Question & Answer system (I don't maintain this package) | -| [BTSync](http://www.getsync.com/) | tifred |
    | https://github.com/drfred1981/btsync_ynh | File synchronization tool | -| [Chtickynotes](https://github.com/chtixof/chtickynotes_ynh) | chtixof |
    | https://github.com/chtixof/chtickynotes_ynh | A Post-it page | -| [COPS](http://cops.com) | lunarok |
    | https://github.com/lunarok/cops_ynh | Frontend for Calibre library | -| [Coquelicot](https://coquelicot.potager.org/) | Moul |
    | https://github.com/M5oul/coquelicot_ynh | “One-click” file sharing focused on users’ privacy | -| [Couchpotato](https://couchpota.to/) | Chao-Man |
    | https://github.com/Chao-Man/couchpotato_ynh | PVR for Usenet and torrents | -| [Covoiturage](https://github.com/SebGit/covoiturage-libre) | ljf |
    | https://git.framasoft.org/ljf/covoiturage_ynh | Car sharing app (french only) | -| [Cubiks-2048](https://kshitij-banerjee.github.io/Cubiks-2048/) | Moul |
    | https://github.com/M5oul/Cubiks-2048_ynh | Clone of 2048 game in 3D | -| Custom Webapp (Multi instance) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/my_webapp_ynh |Custom Webapp | -| [Diaspora](http://diasporafoundation.org) | aymhce |
    | https://github.com/aymhce/diaspora_ynh | Distributed social networking service | -| [Docker Container](https://registry.hub.docker.com/search?q=library) | scith |
    | https://github.com/scith/docker_container_ynh | Docker allows to deploy applications which have not yet been integrated with YunoHost (use with redirect_ynh) | -| [DockerUI](https://registry.hub.docker.com/search?q=library) | scith |
    | https://github.com/scith/dockerui_ynh | DockerUI is a web interface to manage Docker containers and images | -| [EmailPoubelle](http://forge.zici.fr/p/emailpoubelle-php/) | matlink |
    | https://github.com/matlink/emailpoubelle_ynh | Disposable email | -| [EtherCalc](https://ethercalc.org/) | zamentur |
    | https://github.com/zamentur/ethercalc_ynh | Web spreadsheet | -| [Etherpad-Lite](http://etherpad.org) | beudbeud |
    | https://github.com/abeudin/etherpadlite_ynh | Real-time collaborative document editing | -| [FileBin](http://sebsauvage.net/wiki/doku.php?id=php:zerobin) | IsserTerrus |
    | https://github.com/isserterrus/filebin_ynh | Online filebin | -| [Firefox Sync](https://www.mozilla.org/en-US/firefox/sync/) | beudbeud |
    |https://github.com/abeudin/ffsync_ynh | Firefox synchronization server | -| [FramaGames](http://framagames.org/) | polytan02 |
    | https://github.com/polytan02/framagames_ynh | Set of games | -| [FreshRSS](http://freshrss.org/) | plopoyop |
    | https://github.com/plopoyop/freshrss_ynh | RSS reader | -| [Friendica](http://friendica.com) | aymhce |
    | https://github.com/aymhce/friendica_ynh | Social Communication Server | -| FTP support for webapp | Maniack Crudelis |
    | https://github.com/maniackcrudelis/ftp_support_webapp_ynh | FTP support for webapp | -| HotSpot | Jvaubourg |
    | https://github.com/labriqueinternet/hotspot_ynh | Wifi Hotspot for [The Internet Cube](/installation_brique_fr) | -| [HTML Tools](http://lehollandaisvolant.net/tout/tools/)| IsserTerrus |
    | https://github.com/isserterrus/htmltools_ynh | HTML Mini-tools | -| [HTPC Manager](http://htpc.io) | lunarok |
    | https://github.com/lunarok/htpc_ynh | Manage your HTPC | -| [I Hate Money](http://ihatemoney.org/) | JocelynD |
    | https://github.com/JocelynDelalande/ihatemoney_ynh | A simple shared budget manager web application | -|[GateOne](http://liftoffsoftware.com/Products/GateOne)| Kload |
    | https://github.com/Kloadut/gateone_ynh | Web terminal emulator and SSH client | -| [Ghost](http://ghost.org) | ju |
    | https://github.com/julienmalik/ghost_ynh | Blogging platform | -| [Gitolite](https://github.com/sitaramc/gitolite) | matlink |
    | https://github.com/matlink/gitolite_ynh | Hosting git repositories | -| [Gitweb](https://git.wiki.kernel.org/index.php/Gitweb) | matlink |
    | https://github.com/matlink/gitweb_ynh | Web interface for git | -| [GLPI + FusionInventory](http://www.glpi-project.org/?lang=en) | beudbeud |
    | https://github.com/abeudin/glpi_ynh | IT And Asset managent | -| [Gogs](http://gogs.io/) | tostaki |
    | https://github.com/mbugeia/gogs_ynh | self-hosted Git service | -| [Jeedom](http://jeedom.fr) | lunarok |
    | https://github.com/lunarok/jeedom_ynh | Home automation | -| [Jenkins](http://jenkins-ci.org/) | ju |
    | https://github.com/julienmalik/jenkins_ynh | Continuous Integration platform | -| [Jitsi Meet](https://jitsi.org/Projects/JitsiMeet) | ju |
    | https://github.com/julienmalik/jitsi_ynh | Audio/Video web conferencing | -| [Kanboard](http://kanboard.net/) | tostaki |
    | https://github.com/mbugeia/kanboard_ynh | Visual task board | -| [KiwiIRC](http://kiwiirc.com) | ju |
    | https://github.com/julienmalik/kiwiirc_ynh | Web IRC client | -| [Laverna](https://laverna.cc/) | anaqreon |
    | https://github.com/anaqreon/laverna_ynh | Note taking app | -| [Leed](http://projet.idleman.fr/leed/) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/leed_ynh | RSS reader | -| [Let's Chat](http://sdelements.github.io/lets-chat/) | Pierre de La Morinerie |
    | https://github.com/kemenaran/yunohost-lets-chat | Chat for small teams | -| [LimeSurvey](http://www.limesurvey.org/en/) | zamentur |
    | https://github.com/zamentur/limesurvey_ynh | Web survey tool | -| [Linux Dash](http://linuxdash.afaqtariq.com/) | opi |
    | https://github.com/opi/linuxdash_ynh | Monitoring web dashboard | -| [Lychee](http://lychee.electerious.com/) | titoko |
    | https://github.com/titoko/lychee_ynh | Web photo-management | -| [Lutim](https://lut.im/) | Maniack Crudelis

    Matlink |
    | https://github.com/maniackcrudelis/lutim_ynh
    https://github.com/matlink/lutim_ynh | Anonymous image hosting service | -| [MediaGoblin](http://mediagoblin.org/) | Jerome |
    | https://github.com/jeromelebleu/mediagoblin_ynh | Multi-media publishing platform | -| [MediaWiki](https://mediawiki.org) | ElieSauveterre |
    | https://github.com/mikangali-labs/mediawiki_ynh | Wiki platform | -| [minchat](https://github.com/chtixof/minchat_ynh) | chtixof |
    | https://github.com/chtixof/minchat_ynh | Minimalist web chat | -| [miniflux](http://miniflux.net) | matanya |
    | https://github.com/mat-mo/miniflux_ynh | RSS reader via RTL support | -| [Monit](http://mmonit.com/monit/) | ju |
    | https://github.com/julienmalik/monit_ynh | Daemon Monitoring tool | -| [Movim](https://movim.eu) | src386_ |
    | https://github.com/src386/movim_ynh | Kick Ass Social Network | -| [Mumble Admin Plugin](http://wiki.mumble.info/wiki/MAP_-_Mumb1e_Admin_Plugin) | matlink |
    | https://github.com/matlink/mumble_admin_plugin_ynh | Web interface to manage mumble server | -| [Mumble Server](http://wiki.mumble.info/wiki/Main_Page) | matlink |
    | https://github.com/matlink/mumbleserver_ynh | Voice chat for gaming and meeting | -| [Munin](http://munin-monitoring.org/) | ju |
    | https://github.com/julienmalik/munin_ynh | System Monitoring graphing tool | -| [MyCryptoChat](https://github.com/HowTommy/mycryptochat) | mrtino |
    | https://github.com/mrtino/mycryptochat_ynh | Encrypted chat rooms manager | -| [Odoo (Dockerized)](https://www.odoo.com) | scith |
    | https://github.com/scith/docker_odoo_ynh | Odoo is a suite of business apps (ERP: CRM, Accounting, Point of Sale, HR, Purchases...). | -| [OFBiz](https://ofbiz.apache.org/) | julien |
    | https://github.com/nomakaFr/ofbiz_ynh | ERP | -| [OpenDKIM](http://opendkim.org/) | polytan02 |
    | https://github.com/polytan02/opendkim_ynh | OpenDKIM for Yunohost installation script | -| [OpenID](http://openid.net/) | ju |
    | https://github.com/julienmalik/openid-simplesamlphp_ynh | OpenID Identity server | -| [OpenWRT](http://openwrt.org) | lunarok |
    | https://github.com/lunarok/openwrt_ynh | Reverse proxy for OpenWRT installation | -| [phpBB](http://www.phpbb.com/) | polytan02 |
    | https://github.com/polytan02/phpBB_ynh | #1 forum in php with adaptive design - Requires manual configuration after initial installation | -| [phpLDAPadmin](http://phpldapadmin.sourceforge.net/) | aymhce |
    | https://github.com/aymhce/phpldapadmin_ynh | LDAP database web manager | -| [PHPSysinfo](https://phpsysinfo.github.io/phpsysinfo/) | lunarok |
    | https://github.com/lunarok/phpsysinfo_ynh | Informations about your system | -| [PirateBox](https://github.com/jvaubourg/php-piratebox) | Jvaubourg |
    | https://github.com/labriqueinternet/piratebox_ynh | PirateBox for [The Internet Cube](/installation_brique_fr) | -| [Piwigo](http://piwigo.org) | monsieur-a |
    | https://github.com/monsieur-a/piwigo_ynh | Web photo gallery | -| [Piwik](http://piwik.org) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/piwik_ynh_2 | Web analytics platform | -| [Plexmediaserver](https://plex.tv/) | Chao-Man |
    | https://github.com/Novakin/plexmediaserver_ynh | PlexMediaServer | -| [PluXml](http://www.pluxml.org/) | matlink |
    | https://github.com/matlink/pluxml_ynh | Blogging platform | -| [proFTPd](http://www.proftpd.org/) | beudbeud |
    | https://github.com/abeudin/proftpd_ynh | FTP server | -| PSP Adhoc Server | matlink |
    | https://github.com/matlink/adhocserver_ynh | | -| [Pydio](http://pyd.io) | ju |
    | https://github.com/julienmalik/pydio_ynh | File sharing and synchronization | -| [Radicale](http://radicale.org/) | beudbeud |
    | https://github.com/abeudin/radicale_ynh | Caldav & Carddav Server | -| [Rainloop](http://rainloop.net/) | polytan02 |
    | https://github.com/polytan02/rainloop_ynh | Rainloop : nice and simple webmail - configuration by hand | -| [Rainloop](http://rainloop.net/) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/rainloop_ynh | Rainloop : nice and simple webmail - [For advanced users](https://github.com/maniackcrudelis/rainloop_ynh/blob/master/README.md) | -| [Red Matrix](https://redmatrix.me/) | anaqreon |
    | https://github.com/anaqreon/redmatrix_ynh | Social network and decentralized identity platform | -| [Redirect](https://github.com/scith/redirect_ynh) | scith |
    | https://github.com/scith/redirect_ynh | This app allows to create a YunoHost application redirecting to one port and/or path | -| [RStudio (Dockerized)](https://www.rstudio.com/) | scith |
    | https://github.com/scith/docker_rstudio_ynh | RStudio is a web development environment for R (statistics). This app runs through Docker | -| [ruTorrent](https://github.com/Novik/ruTorrent) | CotzaDev |
    | https://github.com/CotzaDev/rutorrent_ynh | A front-end for the popular BitTorrent client rtorrent | -| [Sabnzbd](http://http://sabnzbd.org/) | Chao-Man |
    | https://github.com/Chao-Man/sabnzbd_ynh | Automated Usenet download | -| [SCM-Manager](https://www.scm-manager.org/) | tifred |
    | https://github.com/drfred1981/scm-manager_ynh | Share and manage repositories over HTTP | -| [Seafile](http://seafile.com/) | CotzaDev

    mbugeia |
    | https://github.com/CotzaDev/seafile_ynh
    https://github.com/mbugeia/seafile_ynh | Cloud storage service with encryption | -| [Shaarli](http://sebsauvage.net/wiki/doku.php?id=php:shaarli) | ju |
    | https://github.com/julienmalik/shaarli_ynh | Delicious clone | -| [Shout](http://shout-irc.com/) | kload |
    | https://github.com/Kloadut/shout_ynh | IRC web client (for Debian Jessie only) | -| [Sickbeard](http://sickbeard.com) | Chao-Man |
    | https://github.com/Chao-Man/sickbeard_ynh | PVR and episode guide that downloads and manages all your TV shows | -| [SPIP](http://www.spip.net/) | Cyp |
    | https://github.com/magikcypress/spip_ynh | Web sites/blog | -| [Subsonic](http://subsonic.org) | tifred |
    | https://github.com/drfred1981/subsonic_ynh | Web-based media server | -| [Syncthing](https://syncthing.net/) | tuxmouraille |
    | https://github.com/tuxmouraille/syncthing_ynh | Sync and encrypted service | -| [TagSpaces](http://www.tagspaces.org/) | scith |
    | https://github.com/scith/tagspaces_ynh | Manage files using tags | -| [Telegram](http://www.telegram.org/) | Cyp |
    | https://github.com/magikcypress/telegram_ynh | a new era of messaging | -| Tor Client | Bleuchtang |
    | https://github.com/labriqueinternet/torclient_ynh| Tor Client for [The Internet Cube](/installation_brique_fr) | -| [Tor Relay](https://www.torproject.org/docs/tor-doc-relay.html.en) | matlink |
    | https://github.com/matlink/torrelay_ynh | Tor node | -| [uCoin](http://ucoin.io/) | Moul |
    | https://github.com/ucoin-io/ucoin_ynh | uCoin node:
    free monetary system | -| VPN Client | Jvaubourg |
    | https://github.com/labriqueinternet/vpnclient_ynh | VPN Client for [The Internet Cube](/installation_brique_fr) | -| [Webapp Multi](https://github.com/polytan02/webapp_multi_ynh) | polytan02 |
    | https://github.com/polytan02/webapp_multi_ynh | Multi instances & multi domains web app without FTP support | -| [Webmin](http://webmin.com) | tifred |
    | https://github.com/drfred1981/webmin_ynh | Web-based system configuration tool | -| [Wordpress multisite](http://codex.wordpress.org/Create_A_Network) | Maniack Crudelis |
    | https://github.com/maniackcrudelis/wordpress_ynh | Wordpress with network support | -| [Yify-pop](https://github.com/yify-pop/yify-pop) | m0dm |
    | https://github.com/M0dM/yify-pop_ynh | Inspired by Popcorn Time, a node web server to stream torrents from YIFY. | -| [YaCy](http://yacy.net) | Moul |
    | https://github.com/M5oul/yacy_ynh/ | Libre and decentralized search engine | -| [Yourls](http://yourls.org/) | courgette |
    | https://github.com/courgette/yourls_ynh | URL Shortening service | -| Yunofav | chtixof |
    | https://github.com/chtixof/yunofav | Page of favorite links Yunohost-styled | -| [Zomburl](http://cadav.re/) | courgette |
    | https://github.com/courgette/zomburl_ynh | URL Shortening service | -| [Z-Push](https://z-push.org/) | beudbeud |
    | https://github.com/abeudin/z-push_ynh | ActiveSync Server | +| [20euros](https://jatekos101.github.io/20euros/) | Moul |
    | [Repository](https://github.com/M5oul/20euros_ynh) | Clone of 2048 game with euros | +| [243](https://hgentry.github.io/81/) | Moul |
    | [Repository](https://github.com/M5oul/243_ynh) | Clone of 2048 game: goal reach 243 | +| Ajax google apis | zamentur |
    | [Repository](https://github.com/zamentur/ajaxgoogleapis_ynh) | Google APIs mirror | +| [Adminer](http:/adminer.org/) | Fol |
    | [Repository](https://github.com/jesuisfol/adminer_ynh) | Lightweight database administration tool | +| [Ampache](http://ampache.org/) | beudbeud |
    | [Repository](https://github.com/abeudin/ampache_ynh) | Web based audio/video streaming | +| [AskBot](https://askbot.com/) | Zamentur |
    | [Repository](https://github.com/zamentur/askbot_ynh) | Question & Answer system (I don't maintain this package) | +| [BTSync](http://www.getsync.com/) | tifred |
    | [Repository](https://github.com/drfred1981/btsync_ynh) | File synchronization tool | +| [Chtickynotes](https://github.com/chtixof/chtickynotes_ynh) | chtixof |
    | [Repository](https://github.com/chtixof/chtickynotes_ynh) | A Post-it page | +| [COPS](http://cops.com) | lunarok |
    | [Repository](https://github.com/lunarok/cops_ynh) | Frontend for Calibre library | +| [Coquelicot](https://coquelicot.potager.org/) | Moul |
    | [Repository](https://github.com/M5oul/coquelicot_ynh) | “One-click” file sharing focused on users’ privacy | +| [Couchpotato](https://couchpota.to/) | Chao-Man |
    | [Repository](https://github.com/Chao-Man/couchpotato_ynh) | PVR for Usenet and torrents | +| [Covoiturage](https://github.com/SebGit/covoiturage-libre) | ljf |
    | [Repository](https://git.framasoft.org/ljf/covoiturage_ynh) | Car sharing app (french only) | +| [Cubiks-2048](https://kshitij-banerjee.github.io/Cubiks-2048/) | Moul |
    | [Repository](https://github.com/M5oul/Cubiks-2048_ynh) | Clone of 2048 game in 3D | +| Custom Webapp (Multi instance) | Maniack Crudelis |
    | [Repository](https://github.com/maniackcrudelis/my_webapp_ynh) |Custom Webapp | +| [Diaspora](http://diasporafoundation.org) | aymhce |
    | [Repository](https://github.com/aymhce/diaspora_ynh) | Distributed social networking service | +| [Docker Container](https://registry.hub.docker.com/search?q=library) | scith |
    | [Repository](https://github.com/scith/docker_container_ynh) | Docker allows to deploy applications which have not yet been integrated with YunoHost (use with redirect_ynh) | +| [DockerUI](https://registry.hub.docker.com/search?q=library) | scith |
    | [Repository](https://github.com/scith/dockerui_ynh) | DockerUI is a web interface to manage Docker containers and images | +| [Dotclear](http://dotclear.org/) | rgarrigue |
    | [Repository](https://github.com/rgarrigue/dotclear2_ynh) | Blog, CMS | +| [EmailPoubelle](http://forge.zici.fr/p/emailpoubelle-php/) | matlink |
    | [Repository](https://github.com/matlink/emailpoubelle_ynh) | Disposable email | +| [EtherCalc](https://ethercalc.org/) | zamentur |
    | [Repository](https://github.com/zamentur/ethercalc_ynh) | Web spreadsheet | +| [Etherpad-Lite](http://etherpad.org) | beudbeud |
    | [Repository](https://github.com/abeudin/etherpadlite_ynh) | Real-time collaborative document editing | +| [FileBin](http://sebsauvage.net/wiki/doku.php?id=php:zerobin) | IsserTerrus |
    | [Repository](https://github.com/isserterrus/filebin_ynh) | Online filebin | +| [Firefox Sync](https://www.mozilla.org/en-US/firefox/sync/) | beudbeud |
    | [Repository](https://github.com/abeudin/ffsync_ynh) | Firefox synchronization server | +| [FramaGames](http://framagames.org/) | polytan02 |
    | [Repository](https://github.com/polytan02/framagames_ynh) | Set of games | +| [FreshRSS](http://freshrss.org/) | plopoyop |
    | [Repository](https://github.com/plopoyop/freshrss_ynh) | RSS reader | +| [Friendica](http://friendica.com) | aymhce |
    | [Repository](https://github.com/aymhce/friendica_ynh) | Social Communication Server | +| FTP support for webapp | Maniack Crudelis |
    | [Repository](https://github.com/maniackcrudelis/ftp_support_webapp_ynh) | FTP support for webapp | +| HotSpot | Jvaubourg |
    | [Repository](https://github.com/labriqueinternet/hotspot_ynh) | Wifi Hotspot for [The Internet Cube](/installation_brique_fr) | +| [HTML Tools](http://lehollandaisvolant.net/tout/tools/)| IsserTerrus |
    | [Repository](https://github.com/isserterrus/htmltools_ynh) | HTML Mini-tools | +| [HTPC Manager](http://htpc.io) | lunarok |
    | [Repository](https://github.com/lunarok/htpc_ynh) | Manage your HTPC | +| [I Hate Money](http://ihatemoney.org/) | JocelynD |
    | [Repository](https://github.com/JocelynDelalande/ihatemoney_ynh) | A simple shared budget manager web application | +|[GateOne](http://liftoffsoftware.com/Products/GateOne)| Kload |
    | [Repository](https://github.com/Kloadut/gateone_ynh) | Web terminal emulator and SSH client | +| [Ghost](http://ghost.org) | ju |
    | [Repository](https://github.com/julienmalik/ghost_ynh) | Blogging platform | +| [Gitolite](https://github.com/sitaramc/gitolite) | matlink |
    | [Repository](https://github.com/matlink/gitolite_ynh) | Hosting git repositories | +| [Gitweb](https://git.wiki.kernel.org/index.php/Gitweb) | matlink |
    | [Repository](https://github.com/matlink/gitweb_ynh) | Web interface for git | +| [GLPI + FusionInventory](http://www.glpi-project.org/?lang=en) | beudbeud |
    | [Repository](https://github.com/abeudin/glpi_ynh) | IT And Asset managent | +| [Gogs](http://gogs.io/) | tostaki |
    | [Repository](https://github.com/mbugeia/gogs_ynh) | self-hosted Git service | +| [Jeedom](http://jeedom.fr) | lunarok |
    | [Repository](https://github.com/lunarok/jeedom_ynh) | Home automation | +| [Jenkins](http://jenkins-ci.org/) | ju |
    | [Repository](https://github.com/julienmalik/jenkins_ynh) | Continuous Integration platform | +| [Jitsi Meet](https://jitsi.org/Projects/JitsiMeet) | ju |
    | [Repository](https://github.com/julienmalik/jitsi_ynh) | Audio/Video web conferencing | +| [Kanboard](http://kanboard.net/) | tostaki |
    | [Repository](https://github.com/mbugeia/kanboard_ynh) | Visual task board | +| [KiwiIRC](http://kiwiirc.com) | ju |
    | [Repository](https://github.com/julienmalik/kiwiirc_ynh) | Web IRC client | +| [Laverna](https://laverna.cc/) | anaqreon |
    | [Repository](https://github.com/anaqreon/laverna_ynh) | Note taking app | +| [Leed](http://projet.idleman.fr/leed/) | Maniack Crudelis |
    | [Repository](https://github.com/maniackcrudelis/leed_ynh) | RSS reader | +| [Let's Chat](http://sdelements.github.io/lets-chat/) | Pierre de La Morinerie |
    | [Repository](https://github.com/kemenaran/yunohost-lets-chat) | Chat for small teams | +| [LimeSurvey](http://www.limesurvey.org/en/) | zamentur |
    | [Repository](https://github.com/zamentur/limesurvey_ynh) | Web survey tool | +| [Linux Dash](http://linuxdash.afaqtariq.com/) | opi |
    | [Repository](https://github.com/opi/linuxdash_ynh) | Monitoring web dashboard | +| [Lychee](http://lychee.electerious.com/) | titoko |
    | [Repository](https://github.com/titoko/lychee_ynh) | Web photo-management | +| [Lutim](https://lut.im/) | Maniack Crudelis

    Matlink |
    | [Repository](https://github.com/maniackcrudelis/lutim_ynh)
    [Repository](https://github.com/matlink/lutim_ynh) | Anonymous image hosting service | +| [MediaGoblin](http://mediagoblin.org/) | Jerome |
    | [Repository](https://github.com/jeromelebleu/mediagoblin_ynh) | Multi-media publishing platform | +| [MediaWiki](https://mediawiki.org) | ElieSauveterre |
    | [Repository](https://github.com/mikangali-labs/mediawiki_ynh) | Wiki platform | +| [minchat](https://github.com/chtixof/minchat_ynh) | chtixof |
    | [Repository](https://github.com/chtixof/minchat_ynh) | Minimalist web chat | +| [miniflux](http://miniflux.net) | matanya |
    | [Repository](https://github.com/mat-mo/miniflux_ynh) | RSS reader via RTL support | +| [Monit](http://mmonit.com/monit/) | ju |
    | [Repository](https://github.com/julienmalik/monit_ynh) | Daemon Monitoring tool | +| [Movim](https://movim.eu) | src386_ |
    | [Repository](https://github.com/src386/movim_ynh) | Kick Ass Social Network | +| [Mumble Admin Plugin](http://wiki.mumble.info/wiki/MAP_-_Mumb1e_Admin_Plugin) | matlink |
    | [Repository](https://github.com/matlink/mumble_admin_plugin_ynh) | Web interface to manage mumble server | +| [Mumble Server](http://wiki.mumble.info/wiki/Main_Page) | matlink |
    | [Repository](https://github.com/matlink/mumbleserver_ynh) | Voice chat for gaming and meeting | +| [Munin](http://munin-monitoring.org/) | ju |
    | [Repository](https://github.com/julienmalik/munin_ynh) | System Monitoring graphing tool | +| [MyCryptoChat](https://github.com/HowTommy/mycryptochat) | mrtino |
    | [Repository](https://github.com/mrtino/mycryptochat_ynh) | Encrypted chat rooms manager | +| [Odoo (Dockerized)](https://www.odoo.com) | scith |
    | [Repository](https://github.com/scith/docker_odoo_ynh) | Odoo is a suite of business apps (ERP: CRM, Accounting, Point of Sale, HR, Purchases...). | +| [OFBiz](https://ofbiz.apache.org/) | julien |
    | [Repository](https://github.com/nomakaFr/ofbiz_ynh) | ERP | +| [OpenDKIM](http://opendkim.org/) | polytan02 |
    | [Repository](https://github.com/polytan02/opendkim_ynh) | OpenDKIM for Yunohost installation script | +| [OpenID](http://openid.net/) | ju |
    | [Repository](https://github.com/julienmalik/openid-simplesamlphp_ynh) | OpenID Identity server | +| [OpenWRT](http://openwrt.org) | lunarok |
    | [Repository](https://github.com/lunarok/openwrt_ynh) | Reverse proxy for OpenWRT installation | +| [phpBB](http://www.phpbb.com/) | polytan02 |
    | [Repository](https://github.com/polytan02/phpBB_ynh) | #1 forum in php with adaptive design - Requires manual configuration after initial installation | +| [phpLDAPadmin](http://phpldapadmin.sourceforge.net/) | aymhce |
    | [Repository](https://github.com/aymhce/phpldapadmin_ynh) | LDAP database web manager | +| [PHPSysinfo](https://phpsysinfo.github.io/phpsysinfo/) | lunarok |
    | [Repository](https://github.com/lunarok/phpsysinfo_ynh) | Informations about your system | +| [PirateBox](https://github.com/jvaubourg/php-piratebox) | Jvaubourg |
    | [Repository](https://github.com/labriqueinternet/piratebox_ynh) | PirateBox for [The Internet Cube](/installation_brique_fr) | +| [Piwigo](http://piwigo.org) | monsieur-a |
    | [Repository](https://github.com/monsieur-a/piwigo_ynh) | Web photo gallery | +| [Piwik](http://piwik.org) | Maniack Crudelis |
    | [Repository](https://github.com/maniackcrudelis/piwik_ynh_2) | Web analytics platform | +| [Plexmediaserver](https://plex.tv/) | Chao-Man |
    | [Repository](https://github.com/Novakin/plexmediaserver_ynh) | PlexMediaServer | +| [PluXml](http://www.pluxml.org/) | matlink |
    | [Repository](https://github.com/matlink/pluxml_ynh) | Blogging platform | +| [proFTPd](http://www.proftpd.org/) | beudbeud |
    | [Repository](https://github.com/abeudin/proftpd_ynh) | FTP server | +| PSP Adhoc Server | matlink |
    | [Repository](https://github.com/matlink/adhocserver_ynh) | | +| [Pydio](http://pyd.io) | ju |
    | [Repository](https://github.com/julienmalik/pydio_ynh) | File sharing and synchronization | +| [Radicale](http://radicale.org/) | beudbeud |
    | [Repository](https://github.com/abeudin/radicale_ynh) | Caldav & Carddav Server | +| [Rainloop](http://rainloop.net/) | polytan02 |
    | [Repository](https://github.com/polytan02/rainloop_ynh) | Rainloop : nice and simple webmail - configuration by hand | +| [Rainloop](http://rainloop.net/) | Maniack Crudelis |
    | [Repository](https://github.com/maniackcrudelis/rainloop_ynh) | Rainloop : nice and simple webmail - [For advanced users](https://github.com/maniackcrudelis/rainloop_ynh/blob/master/README.md) | +| [Red Matrix](https://redmatrix.me/) | anaqreon |
    | [Repository](https://github.com/anaqreon/redmatrix_ynh) | Social network and decentralized identity platform | +| [Redirect](https://github.com/scith/redirect_ynh) | scith |
    | [Repository](https://github.com/scith/redirect_ynh) | This app allows to create a YunoHost application redirecting to one port and/or path | +| [RStudio (Dockerized)](https://www.rstudio.com/) | scith |
    | [Repository](https://github.com/scith/docker_rstudio_ynh) | RStudio is a web development environment for R (statistics). This app runs through Docker | +| [ruTorrent](https://github.com/Novik/ruTorrent) | CotzaDev |
    | [Repository](https://github.com/CotzaDev/rutorrent_ynh) | A front-end for the popular BitTorrent client rtorrent | +| [Sabnzbd](http://http://sabnzbd.org/) | Chao-Man |
    | [Repository](https://github.com/Chao-Man/sabnzbd_ynh) | Automated Usenet download | +| [SCM-Manager](https://www.scm-manager.org/) | tifred |
    | [Repository](https://github.com/drfred1981/scm-manager_ynh) | Share and manage repositories over HTTP | +| [Seafile](http://seafile.com/) | CotzaDev

    mbugeia |
    | [Repository](https://github.com/CotzaDev/seafile_ynh)
    [Repository](https://github.com/mbugeia/seafile_ynh) | Cloud storage service with encryption | +| [Shaarli](http://sebsauvage.net/wiki/doku.php?id=php:shaarli) | ju |
    | [Repository](https://github.com/julienmalik/shaarli_ynh) | Delicious clone | +| [Shout](http://shout-irc.com/) | kload |
    | [Repository](https://github.com/Kloadut/shout_ynh) | IRC web client (for Debian Jessie only) | +| [Sickbeard](http://sickbeard.com) | Chao-Man |
    | [Repository](https://github.com/Chao-Man/sickbeard_ynh) | PVR and episode guide that downloads and manages all your TV shows | +| [SPIP](http://www.spip.net/) | Cyp |
    | [Repository](https://github.com/magikcypress/spip_ynh) | Web sites/blog | +| [Subsonic](http://subsonic.org) | tifred |
    | [Repository](https://github.com/drfred1981/subsonic_ynh) | Web-based media server | +| [Syncthing](https://syncthing.net/) | tuxmouraille |
    | [Repository](https://github.com/tuxmouraille/syncthing_ynh) | Sync and encrypted service | +| [TagSpaces](http://www.tagspaces.org/) | scith |
    | [Repository](https://github.com/scith/tagspaces_ynh) | Manage files using tags | +| [Telegram](http://www.telegram.org/) | Cyp |
    | [Repository](https://github.com/magikcypress/telegram_ynh) | a new era of messaging | +| Tor Client | Bleuchtang |
    | [Repository](https://github.com/labriqueinternet/torclient_ynh) | Tor Client for [The Internet Cube](/installation_brique_fr) | +| [Tor Relay](https://www.torproject.org/docs/tor-doc-relay.html.en) | matlink |
    | [Repository](https://github.com/matlink/torrelay_ynh) | Tor node | +| [uCoin](http://ucoin.io/) | Moul |
    | [Repository](https://github.com/ucoin-io/ucoin_ynh) | uCoin node:
    free monetary system | +| VPN Client | Jvaubourg |
    | [Repository](https://github.com/labriqueinternet/vpnclient_ynh) | VPN Client for [The Internet Cube](/installation_brique_fr) | +| [Webapp Multi](https://github.com/polytan02/webapp_multi_ynh) | polytan02 |
    | [Repository](https://github.com/polytan02/webapp_multi_ynh) | Multi instances & multi domains web app without FTP support | +| [Webmin](http://webmin.com) | tifred |
    | [Repository](https://github.com/drfred1981/webmin_ynh) | Web-based system configuration tool | +| [Wordpress multisite](http://codex.wordpress.org/Create_A_Network) | Maniack Crudelis |
    | [Repository](https://github.com/maniackcrudelis/wordpress_ynh) | Wordpress with network support | +| [Yify-pop](https://github.com/yify-pop/yify-pop) | m0dm |
    | [Repository](https://github.com/M0dM/yify-pop_ynh) | Inspired by Popcorn Time, a node web server to stream torrents from YIFY. | +| [YaCy](http://yacy.net) | Moul |
    | [Repository](https://github.com/M5oul/yacy_ynh/) | Libre and decentralized search engine | +| [Yourls](http://yourls.org/) | courgette |
    | [Repository](https://github.com/courgette/yourls_ynh) | URL Shortening service | +| Yunofav | chtixof |
    | [Repository](https://github.com/chtixof/yunofav) | Page of favorite links Yunohost-styled | +| [Zomburl](http://cadav.re/) | courgette |
    | [Repository](https://github.com/courgette/zomburl_ynh) | URL Shortening service | +| [Z-Push](https://z-push.org/) | beudbeud |
    | [Repository](https://github.com/abeudin/z-push_ynh) | ActiveSync Server |