This commit is contained in:
Yunohost-Bot 2021-02-18 21:46:54 +00:00
commit e129e5bb11
26 changed files with 136 additions and 67 deletions

View file

@ -2,7 +2,7 @@
Voici une liste des bureaux denregistrement pour acheter un nom de domaine : Voici une liste des bureaux denregistrement pour acheter un nom de domaine :
* [OVH](http://ovh.com/) * [OVH](http://ovh.com/)
* [GoDaddy](https://godaddy.com/)
* [Gandi](http://gandi.net/) * [Gandi](http://gandi.net/)
* [Namecheap](https://www.namecheap.com/) * [Namecheap](https://www.namecheap.com/)
* [BookMyName](https://www.bookmyname.com/) * [BookMyName](https://www.bookmyname.com/)
* [GoDaddy](https://godaddy.com/) /!\ GoDaddy is [not a good example about censorship](https://en.wikipedia.org/wiki/GoDaddy#Controversies)

View file

@ -2,7 +2,7 @@
Here is a list of Registrars to book domain names: Here is a list of Registrars to book domain names:
* [OVH](http://ovh.com/) * [OVH](http://ovh.com/)
* [GoDaddy](https://godaddy.com/)
* [Gandi](http://gandi.net/) * [Gandi](http://gandi.net/)
* [Namecheap](https://www.namecheap.com/) * [Namecheap](https://www.namecheap.com/)
* [BookMyName](https://www.bookmyname.com/) * [BookMyName](https://www.bookmyname.com/)
* [GoDaddy](https://godaddy.com/) /!\ GoDaddy is [not a good example about censorship](https://en.wikipedia.org/wiki/GoDaddy#Controversies)

View file

@ -15,13 +15,13 @@ Pratiquer l'auto-hébergement ne rend pas "votre internet" plus sécurisé et ne
## Pourquoi s'auto-héberger ? ## Pourquoi s'auto-héberger ?
- **Vous croyez en un internet libre, ouvert et décentralisé.** Dans un internet centralisé, les entités privées et les gouvernement peuvent espionner, analyser et influencer les personnes en dictant la façon dont elle peuvent interagir les unes avec les autres, ainsi qu'en filtrant du contenu. YunoHost est développé par une communauté qui croit en un internet ouvert et décentralisé. Nous espérons que vous aussi ! - **Vous croyez en un internet libre, ouvert et décentralisé.** Dans un internet centralisé, les entités privées et les gouvernements peuvent espionner, analyser et influencer les personnes en dictant la façon dont elle peuvent interagir les unes avec les autres, ainsi qu'en filtrant du contenu. YunoHost est développé par une communauté qui croit en un internet ouvert et décentralisé. Nous espérons que vous aussi !
- **Vous voulez avoir le contrôle de vos données et services.** Vos images, vos messages de chat, votre historique de navigation, et votre dissertation pour l'école n'ont rien à faire sur l'ordinateur de quelqu'un d'autre (a.k.a. le Cloud). Ces données font parties de votre vie privée, mais également de celle de votre famille, de vos amis, etc. Ces données devraient être gérées par *vous*, et non par une quelconque entreprise américaine qui cherche à analyser vos données pour revendre les résultats. - **Vous voulez avoir le contrôle de vos données et services.** Vos images, vos messages de chat, votre historique de navigation, et votre dissertation pour l'école n'ont rien à faire sur l'ordinateur de quelqu'un d'autre (a.k.a. le Cloud). Ces données font partie de votre vie privée, mais également de celle de votre famille, de vos amis, etc. Ces données devraient être gérées par *vous*, et non par une quelconque entreprise américaine qui cherche à analyser vos données pour revendre les résultats.
- **Vous souhaitez apprendre comment fonctionnent les ordinateurs et Internet.** Opérer son propre serveur est un bon contexte pour apprendre les mécanismes de base au cœur des systèmes d'exploitations (OS) et d'Internet. Il vous faudra possiblement toucher à la ligne de commande et à des morceaux de configuration réseau et DNS. - **Vous souhaitez apprendre comment fonctionnent les ordinateurs et Internet.** Opérer son propre serveur est un bon contexte pour apprendre les mécanismes de base au cœur des systèmes d'exploitation (OS) et d'Internet. Il vous faudra possiblement toucher à la ligne de commande et à des morceaux de configuration réseau et DNS.
- **Vous voulez explorer de nouvelles possibilités et personnaliser votre espace.** Avez-vous déjà rêvé d'avoir votre propre serveur Minecraft pour vos ami·e·s, ou un client IRC ou XMPP persistent ? Avec votre propre serveur, vous pouvez manuellement installer et faire tourner n'importe quel programme et personnaliser chaque morceau. - **Vous voulez explorer de nouvelles possibilités et personnaliser votre espace.** Avez-vous déjà rêvé d'avoir votre propre serveur Minecraft pour vos ami·e·s, ou un client IRC ou XMPP persistant ? Avec votre propre serveur, vous pouvez manuellement installer et faire tourner n'importe quel programme et personnaliser chaque morceau.
## Pourquoi ne *pas* s'auto-héberger ? ## Pourquoi ne *pas* s'auto-héberger ?
@ -29,4 +29,4 @@ Pratiquer l'auto-hébergement ne rend pas "votre internet" plus sécurisé et ne
- **Avec de grands serveurs viennent les grandes responsabilités.** Opérer un serveur implique d'être responsable des données que vous hébergez : personne ne pourra récupérer des données à votre place si vous les perdez. YunoHost fournit des fonctionnalités de sauvegarde qu'il est recommandé d'utiliser pour sauvegarder les configurations et données importantes. Il vous faut aussi garder un œil sur les recommandations et les nouvelles à propos de la sécurité pour que votre serveur ou vos données ne soient pas compromises. - **Avec de grands serveurs viennent les grandes responsabilités.** Opérer un serveur implique d'être responsable des données que vous hébergez : personne ne pourra récupérer des données à votre place si vous les perdez. YunoHost fournit des fonctionnalités de sauvegarde qu'il est recommandé d'utiliser pour sauvegarder les configurations et données importantes. Il vous faut aussi garder un œil sur les recommandations et les nouvelles à propos de la sécurité pour que votre serveur ou vos données ne soient pas compromises.
- **La qualité et les performances ne seront probablement pas aussi bonnes que des services premium.** YunoHost (et la plupart des applications qui sont packagées) sont des logiciels libres et open-source, développés par des communautés bénévoles. Il n'y a pas de garantie absolue que ces logiciels marcheront dans toutes les circonstances possibles. Les performances de votre serveur auto-hébergé sont aussi liées au processeur, à la mémoire vive et à la connectivité internet. - **La qualité et les performances ne seront probablement pas aussi bonnes que des services premium.** YunoHost (et la plupart des applications qui sont packagées) sont des logiciels libres et open-source, développés par des communautés bénévoles. Il n'y a pas de garantie absolue que ces logiciels fonctionneront dans toutes les circonstances possibles. Les performances de votre serveur auto-hébergé sont aussi liées au processeur, à la mémoire vive et à la connectivité internet.

View file

@ -7,7 +7,7 @@ routes:
default: '/try' default: '/try'
--- ---
! **Note :** Cette démo peut cesser de fonctionner de temps en temps. ! **Note :** Cette démo peut cesser de fonctionner de temps en temps, mais au moins vous pouvez tester, et ça cest vraiment chouette :)
[center] [center]
[columns] [columns]

View file

@ -7,7 +7,7 @@ routes:
default: '/try' default: '/try'
--- ---
! This demo server could be down from time to time. ! This demo server could be down from time to time, but at least you can test and that's really cool :)
[center] [center]
[columns] [columns]

View file

@ -13,7 +13,7 @@ Si vous vous auto-hébergez à la maison et sans VPN, il vous faut rediriger les
[figure caption="Illustration de l'importance de la redirection des ports"]![](image://portForwarding_fr.png)[/figure] [figure caption="Illustration de l'importance de la redirection des ports"]![](image://portForwarding_fr.png)[/figure]
[Cette page](https://craym.eu/tutoriels/utilitaires/ouvrir_les_ports_de_sa_box.html) propose également des explications détaillées sur le fonctionnement des ports, et les étapes de configuration pour différents routeurs [Cette page](https://craym.eu/tutoriels/utilitaires/ouvrir_les_ports_de_sa_box.html) propose également des explications détaillées sur le fonctionnement des ports, et les étapes de configuration pour différents routeurs.
### 0. Diagnostiquer les ports ouverts ### 0. Diagnostiquer les ports ouverts
@ -42,7 +42,7 @@ Dans l'interface d'administration de votre box/routeur, il vous faut trouver
une catégorie comme 'Configuration du routeur', ou 'Redirections de ports'. Le une catégorie comme 'Configuration du routeur', ou 'Redirections de ports'. Le
nom diffère suivant le type / marque de la box... nom diffère suivant le type / marque de la box...
Il vous faut ensuite rediriger chacun des ports listés ci-dessous vers l'IP locale de votre serveur pour que les différents services de YunoHost fonctionnent. Pour chacun d'eux, une redirection 'TCP' est nécessaire. Certains interfaces font références à un port 'externe' et un port 'interne' : dans notre cas il s'agit du même. Il vous faut ensuite rediriger chacun des ports listés ci-dessous vers l'IP locale de votre serveur pour que les différents services de YunoHost fonctionnent. Pour chacun d'eux, une redirection 'TCP' est nécessaire. Certaines interfaces font référence à un port 'externe' et un port 'interne' : dans notre cas il s'agit du même.
* Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small> * Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
* [SSH](/ssh): 22 * [SSH](/ssh): 22

View file

@ -8,7 +8,7 @@ routes:
--- ---
DNS (système de nom de domaine) est un élément essentiel d'Internet qui permet DNS (système de nom de domaine) est un élément essentiel d'Internet qui permet
de convertir des adresses compréhensible par les êtres humains (les noms de de convertir des adresses compréhensibles par les êtres humains (les noms de
domaines) en adresses compréhensibles par la machine (les IPs). Pour que domaines) en adresses compréhensibles par la machine (les IPs). Pour que
votre serveur soit facilement accessible par d'autres êtres humains, et pour votre serveur soit facilement accessible par d'autres êtres humains, et pour
que certains services comme le mail fonctionnent correctement, il est nécessaire que certains services comme le mail fonctionnent correctement, il est nécessaire
@ -86,7 +86,7 @@ suivante :
- Tous ces enregistrements ne sont pas nécessaires. Pour une installation minimale, seuls les enregistrements en gras sont nécessaires ; - Tous ces enregistrements ne sont pas nécessaires. Pour une installation minimale, seuls les enregistrements en gras sont nécessaires ;
- Le point à la fin de `votre.domaine.tld.` est important ;) ; - Le point à la fin de `votre.domaine.tld.` est important ;) ;
- `@` corresponds à `votre.domaine.tld`, et par ex. `muc` corresponds à `muc.votre.domaine.tld` ; - `@` correspond à `votre.domaine.tld`, et par ex. `muc` correspond à `muc.votre.domaine.tld` ;
- Les valeurs montrées ici sont des valeurs d'exemple ! Référez-vous à la configuration générée chez vous pour savoir quelles valeurs utiliser ; - Les valeurs montrées ici sont des valeurs d'exemple ! Référez-vous à la configuration générée chez vous pour savoir quelles valeurs utiliser ;
- Nous recommandons un [TTL](https://fr.wikipedia.org/wiki/Time_to_Live#Le_Time_to_Live_dans_le_DNS) de 3600 (1 heure). Mais vous pouvez utiliser une autre valeur si vous savez ce que vous faîtes ; - Nous recommandons un [TTL](https://fr.wikipedia.org/wiki/Time_to_Live#Le_Time_to_Live_dans_le_DNS) de 3600 (1 heure). Mais vous pouvez utiliser une autre valeur si vous savez ce que vous faîtes ;
- Ne mettez pas d'enregistrement IPv6 si vous n'êtes pas certains que l'IPv6 fonctionne sur votre serveur ! Vous aurez des problèmes avec Let's Encrypt si ce n'est pas le cas. - Ne mettez pas d'enregistrement IPv6 si vous n'êtes pas certains que l'IPv6 fonctionne sur votre serveur ! Vous aurez des problèmes avec Let's Encrypt si ce n'est pas le cas.

View file

@ -130,7 +130,7 @@ Sélectionnez le matériel sur lequel vous souhaitez installer YunoHost :
{% if hardware != '' %} {% if hardware != '' %}
{% if docker %} {% if docker %}
!! **YunoHost ne supporte plus officiellement Docker depuis les problèmes rencontrés avec la version 2.4+. En cause, YunoHost dépend désormait de systemd et docker a décidé quils ne le supporteraient pas nativement (et il y a d'autres problèmes liés au firewall et aux services).** !! **YunoHost ne supporte plus officiellement Docker depuis les problèmes rencontrés avec la version 2.4+. En cause, YunoHost dépend désormais de systemd et Docker a décidé quil ne le supporterait pas nativement (et il y a d'autres problèmes liés au firewall et aux services).**
!! !!
!! **Nous vous décourageons fortement d'utiliser YunoHost sur docker avec ces images** !! **Nous vous décourageons fortement d'utiliser YunoHost sur docker avec ces images**
@ -138,9 +138,10 @@ Sélectionnez le matériel sur lequel vous souhaitez installer YunoHost :
Cependant, ces images communautaires existent et sont disponibles sur Docker Hub: Cependant, ces images communautaires existent et sont disponibles sur Docker Hub:
* [AMD64 (classic) (ancienne version de YunoHost)](https://hub.docker.com/r/domainelibre/yunohost/) * [AMD64 (classic) (YunoHost 4.x)](https://hub.docker.com/r/domainelibre/yunohost/)
* [I386 (old computers) (ancienne version de YunoHost)](https://hub.docker.com/r/domainelibre/yunohost-i386/) * [I386 (old computers) (YunoHost 4.x)](https://hub.docker.com/r/domainelibre/yunohost-i386/)
* [ARMV7 (Raspberry Pi 2/3 ...) (ancienne version de YunoHost)](https://hub.docker.com/r/domainelibre/yunohost-arm/) * [ARM64V8 (Raspberry Pi 4) (YunoHost 4.x)](https://hub.docker.com/r/cms0/yunohost/)
* [ARMV7 (Raspberry Pi 2/3 ...) (YunoHost 4.x)](https://hub.docker.com/r/domainelibre/yunohost-arm/)
* [ARMV6 (Raspberry Pi 1) (ancienne version de YunoHost)](https://hub.docker.com/r/tuxalex/yunohost-armv6/) * [ARMV6 (Raspberry Pi 1) (ancienne version de YunoHost)](https://hub.docker.com/r/tuxalex/yunohost-armv6/)
{% else %} {% else %}
@ -174,7 +175,7 @@ Cependant, ces images communautaires existent et sont disponibles sur Docker Hub
* Une carte microSD : 16Go de capacité (au moins), [classe « A1 »](https://fr.wikipedia.org/wiki/Carte_SD#Vitesse) hautement recommandée (comme par exemple [cette carte SanDisk A1](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/)) ; * Une carte microSD : 16Go de capacité (au moins), [classe « A1 »](https://fr.wikipedia.org/wiki/Carte_SD#Vitesse) hautement recommandée (comme par exemple [cette carte SanDisk A1](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/)) ;
{% endif %} {% endif %}
{% if regular %} {% if regular %}
* Une clé USB avec au moins 1Go de capacité OU un CD viege standard ; * Une clé USB avec au moins 1Go de capacité OU un CD vierge standard ;
{% endif %} {% endif %}
{% if at_home %} {% if at_home %}
* Un [fournisseur d'accès internet correct](/isp), de préférence avec une bonne vitesse dupload ; * Un [fournisseur d'accès internet correct](/isp), de préférence avec une bonne vitesse dupload ;
@ -352,7 +353,7 @@ Pour les anciens matériels, il vous faut peut-être utiliser un CD/DVD. Le logi
## Modifier la configuration réseau ## Modifier la configuration réseau
! Cette étape est importante pour exposer proprement la machine virtuelle sur le réseau ! Cette étape est importante pour exposer proprement la machine virtuelle sur le réseau.
Allez dans **Réglages** > **Réseau** : Allez dans **Réglages** > **Réseau** :
@ -381,12 +382,12 @@ Allez dans **Réglages** > **Réseau** :
* (Faculatif) Il est possible de brancher un écran et clavier sur votre serveur en cas de soucis ou pour vérifier que le processus de démarrage (boot) se passe bien ou encore pour avoir un accès direct en console. * (Faculatif) Il est possible de brancher un écran et clavier sur votre serveur en cas de soucis ou pour vérifier que le processus de démarrage (boot) se passe bien ou encore pour avoir un accès direct en console.
* Branchez l'alimentation. * Branchez l'alimentation.
* Laissez quelques minutes à votre serveur pour s'autoconfigurer durant le premier démarrage. * Laissez quelques minutes à votre serveur pour s'autoconfigurer durant le premier démarrage.
* Assurez vous que votre ordinateur (de bureau ou portable) est connecté au même réseau local (c'est-à-dire la même box internet) que votre serveur. * Assurez-vous que votre ordinateur (de bureau ou portable) est connecté au même réseau local (c'est-à-dire la même box internet) que votre serveur.
{% elseif virtualbox %} {% elseif virtualbox %}
## [fa=plug /] Lancer la machine virtuelle ## [fa=plug /] Lancer la machine virtuelle
Démarrez votre machine virtuelle aprés avoir sélectionné l'image YunoHost. Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost.
![](image://virtualbox_2.1.png?class=inline) ![](image://virtualbox_2.1.png?class=inline)
@ -395,7 +396,7 @@ Démarrez votre machine virtuelle aprés avoir sélectionné l'image YunoHost.
{% else %} {% else %}
## [fa=plug /] Démarrer la machine sur la clé USB ## [fa=plug /] Démarrer la machine sur la clé USB
* Branchez le cable ethernet (un côté à votre box, de l'autre côté à votre carte). * Branchez le câble ethernet (un côté à votre box, de l'autre côté à votre carte).
* Démarrez votre serveur avec la clé USB ou le CD-ROM inséré, et sélectionnez-le comme **périphérique de démarrage (bootable device)** en pressant lune des touches suivantes (dépendant de votre ordinateur) : * Démarrez votre serveur avec la clé USB ou le CD-ROM inséré, et sélectionnez-le comme **périphérique de démarrage (bootable device)** en pressant lune des touches suivantes (dépendant de votre ordinateur) :
`<ESC>`, `<F9>`, `<F10>`, `<F11>`, `<F12>` or `<DEL>`. `<ESC>`, `<F9>`, `<F10>`, `<F11>`, `<F12>` or `<DEL>`.
* N.B. : si le serveur était précédemment installé avec une version récente de Windows (8+), vous devez d'abord demander à Windows de « redémarrer réellement ». Vous pouvez le faire dans une oiption du menu « Options de démarrage avancées ». * N.B. : si le serveur était précédemment installé avec une version récente de Windows (8+), vous devez d'abord demander à Windows de « redémarrer réellement ». Vous pouvez le faire dans une oiption du menu « Options de démarrage avancées ».
@ -423,7 +424,7 @@ Vous devriez voir un écran comme ça :
## [fa=bug /] Se connecter à la carte et corriger l'image ## [fa=bug /] Se connecter à la carte et corriger l'image
Les Raspberry Pi 1 et 0 ne sont pas totalement supportés à cause de [problèmes de compilation pour cette architecture](https://github.com/YunoHost/issues/issues/1423). Les Raspberry Pi 1 et 0 ne sont pas totalement supportés à cause de [problèmes de compilation pour cette architecture](https://github.com/YunoHost/issues/issues/1423).
Cependant, il est possible de corriger l'image par vous même avant de lancer la configuration initiale. Cependant, il est possible de corriger l'image par vous-même avant de lancer la configuration initiale.
Pour y parvenir, vous devez vous connectez à votre Raspberry Pi en tant que root [via SSH](/ssh) avec le mot de passe temporaire `yunohost`: Pour y parvenir, vous devez vous connectez à votre Raspberry Pi en tant que root [via SSH](/ssh) avec le mot de passe temporaire `yunohost`:
``` ```
@ -491,7 +492,7 @@ Dans un navigateur web, tapez dans la barre d'adresse **{% if internetcube %}`ht
Vous pouvez lancer la configuration initiale à partir du navigateur en tapant l'**adresse IP publique de votre serveur**. Généralement, votre fournisseur de VPS vous indique l'IP dans un mail ou sur sa console de gestion. Vous pouvez lancer la configuration initiale à partir du navigateur en tapant l'**adresse IP publique de votre serveur**. Généralement, votre fournisseur de VPS vous indique l'IP dans un mail ou sur sa console de gestion.
{% endif %} {% endif %}
! Lors de la première visite, vous rencontrerez très probablement un avertissement de sécurité lié au certificat utilisé. Pour le moment, votre serveur utilise un certificat auto-signé. Vous pourrez plus tard ajouter un certificat automatiquement reconnus par les navigateurs comme décrit dans [la page sur les certificats](/certificate). En attendant, ajoutez une exception de sécurité pour accepter le certificat actuel. Toutefois, **s'il-vous-plaît**, ne prenez pas l'habitude d'accepter ce genre d'alerte de sécurité ! ! Lors de la première visite, vous rencontrerez très probablement un avertissement de sécurité lié au certificat utilisé. Pour le moment, votre serveur utilise un certificat auto-signé. Vous pourrez plus tard ajouter un certificat automatiquement reconnus par les navigateurs comme décrit dans [la page sur les certificats](/certificate). En attendant, ajoutez une exception de sécurité pour accepter le certificat actuel. Toutefois, **s'il vous plaît**, ne prenez pas l'habitude d'accepter ce genre d'alerte de sécurité !
{% if not internetcube %} {% if not internetcube %}
Vous devriez ensuite obtenir cette page : Vous devriez ensuite obtenir cette page :
@ -517,7 +518,7 @@ Vous pouvez aussi lancer la post-installation avec la commande `yunohost tools p
##### [fa=globe /] Domaine principal ##### [fa=globe /] Domaine principal
Cest le nom de domaine qui permettra laccès à votre serveur ainsi quau **portail dauthentification** des utilisateurs. Vous pourrez ensuite ajouter d'autres domaines, et changer celui qui sera le domaine principale si besoin. Cest le nom de domaine qui permettra laccès à votre serveur ainsi quau **portail dauthentification** des utilisateurs. Vous pourrez ensuite ajouter d'autres domaines, et changer celui qui sera le domaine principal si besoin.
* Si l'auto-hébergement est tout neuf pour vous et que vous n'avez pas encore de nom de domaine, nous recommandons d'utiliser un domaine en **.nohost.me** / **.noho.st** / **.ynh.fr** (exemple : `homersimpson.nohost.me`). S'il n'est pas déjà utilisé, le domaine sera automatiquement rattaché à votre serveur YunoHost, et vous naurez pas détape de configuration supplémentaire. Toutefois, notez que l'utilisation d'un de ces noms de domaines implique que vous n'aurez pas le contôle complet sur votre configuration DNS. * Si l'auto-hébergement est tout neuf pour vous et que vous n'avez pas encore de nom de domaine, nous recommandons d'utiliser un domaine en **.nohost.me** / **.noho.st** / **.ynh.fr** (exemple : `homersimpson.nohost.me`). S'il n'est pas déjà utilisé, le domaine sera automatiquement rattaché à votre serveur YunoHost, et vous naurez pas détape de configuration supplémentaire. Toutefois, notez que l'utilisation d'un de ces noms de domaines implique que vous n'aurez pas le contôle complet sur votre configuration DNS.
@ -536,7 +537,7 @@ Bien que votre serveur dispose maintenant d'un utilisateur `admin`, cet utilisat
Par conséquent, vous devriez ajouter un premier utilisateur « standard ». Par conséquent, vous devriez ajouter un premier utilisateur « standard ».
!!! Le premier utilisateur que vous créez est un peu spéciale : il recevra les emails envoyé à `root@votredomaine.tld` et `admin@votredomaine.tld`. Ces emails peuvent être utilisés pour envoyer des informations ou des alertes techniques. !!! Le premier utilisateur que vous créez est un peu spécial : il recevra les emails envoyés à `root@votredomaine.tld` et `admin@votredomaine.tld`. Ces emails peuvent être utilisés pour envoyer des informations ou des alertes techniques.
[ui-tabs position="top-left" active="0" theme="lite"] [ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="A partir de l'interface web"] [ui-tab title="A partir de l'interface web"]
@ -557,15 +558,15 @@ TODO : copypasta an actual shell session will all info asked etc..
## [fa=stethoscope /] Lancer le diagnostic ## [fa=stethoscope /] Lancer le diagnostic
Le système de diagnostique est conçu pour fournir un moyen facile de valider que tous les aspects critiques de votre serveur sont proprement configuré et pour vous guider dans la résolution des problèmes soulevés. Le diagnostique se lance deux fois par jour et envoie une alerte si un dysfonctionnement est détecté. Le système de diagnostic est conçu pour fournir un moyen facile de valider que tous les aspects critiques de votre serveur sont proprement configurés et pour vous guider dans la résolution des problèmes soulevés. Le diagnostic se lance deux fois par jour et envoie une alerte si un dysfonctionnement est détecté.
!!! N.B. : **ne partez pas en courant** ! La première fois que vous lancerez le diagnostique, il est assez normal d'avoir plusieurs alertes rouges ou jaunes car vous devez généralement [configurer les enregistrements DNS](/dns_config) (si vous n'utilisez pas un domaine `.nohost.me`, `.noho.st` ou `.ynh.fr`){%if at_home %} et/ou [configurer la redirection des ports](/isp_box_config){% endif %}. !!! N.B. : **ne partez pas en courant** ! La première fois que vous lancerez le diagnostic, il est assez normal d'avoir plusieurs alertes rouges ou jaunes car vous devez généralement [configurer les enregistrements DNS](/dns_config) (si vous n'utilisez pas un domaine `.nohost.me`, `.noho.st` ou `.ynh.fr`), ajouter un fichier de swap {%if at_home %} et/ou [configurer la redirection des ports](/isp_box_config){% endif %}.
!!! Si une alerte n'est pas pertinente (par exemple parce que vous ne pensez pas utiliser une fonctionnalité spécifique), il est tout à fait convenable d'indiquer le dysfonctionnement comme « À ignorer » en allant dans l'administration web > Diagnostic, et en cliquant sur bouton « Ignorer » pour ce dysfonctionnement spécifique. !!! Si une alerte n'est pas pertinente (par exemple parce que vous ne pensez pas utiliser une fonctionnalité spécifique), il est tout à fait convenable d'indiquer le dysfonctionnement comme « À ignorer » en allant dans l'administration web > Diagnostic, et en cliquant sur bouton « Ignorer » pour ce dysfonctionnement spécifique.
[ui-tabs position="top-left" active="0" theme="lite"] [ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="(Recommandé) A partir de l'interface web"] [ui-tab title="(Recommandé) A partir de l'interface web"]
Pour lancer le diagnostique, allez dans l'Administration Web dans la partie Diagnostique. Vous devriez obtenir un écran comme celui-ci : Pour lancer le diagnostic, allez dans l'Administration Web dans la partie Diagnostic. Vous devriez obtenir un écran comme celui-ci :
[figure class="nomargin" caption="Capture d'écran du panneau de diagnostic"] [figure class="nomargin" caption="Capture d'écran du panneau de diagnostic"]
![](image://diagnostic.png?resize=100%&class=inline) ![](image://diagnostic.png?resize=100%&class=inline)

View file

@ -138,9 +138,10 @@ Select the hardware on which you want install YunoHost :
However, community images exist and are available on Docker Hub: However, community images exist and are available on Docker Hub:
* [AMD64 (classic) (old YunoHost version)](https://hub.docker.com/r/domainelibre/yunohost/) * [AMD64 (classic) (YunoHost 4.x)](https://hub.docker.com/r/domainelibre/yunohost/)
* [I386 (old computers) (old YunoHost version)](https://hub.docker.com/r/domainelibre/yunohost-i386/) * [I386 (old computers) (YunoHost 4.x)](https://hub.docker.com/r/domainelibre/yunohost-i386/)
* [ARMV7 (Raspberry Pi 2/3 ...) (old YunoHost version)](https://hub.docker.com/r/domainelibre/yunohost-arm/) * [ARM64V8 (Raspberry Pi 4) (YunoHost 4.x)](https://hub.docker.com/r/cms0/yunohost/)
* [ARMV7 (Raspberry Pi 2/3 ...) (YunoHost 4.x)](https://hub.docker.com/r/domainelibre/yunohost-arm/)
* [ARMV6 (Raspberry Pi 1) (old yunoHost version)](https://hub.docker.com/r/tuxalex/yunohost-armv6/) * [ARMV6 (Raspberry Pi 1) (old yunoHost version)](https://hub.docker.com/r/tuxalex/yunohost-armv6/)
{% else %} {% else %}
@ -560,7 +561,7 @@ TODO : copypasta an actual shell session will all info asked etc..
The diagnosis system is meant to provide an easy way to validate that all critical aspects of your server are properly configured - and guide you in how to fix issues. The diagnosis will run twice a day and send an alert if issues are detected. The diagnosis system is meant to provide an easy way to validate that all critical aspects of your server are properly configured - and guide you in how to fix issues. The diagnosis will run twice a day and send an alert if issues are detected.
!!! N.B. : **don't run away** ! The first time you run the diagnosis, it is quite expected to see a bunch of yellow/red alerts because you typically need to [configure DNS records](/dns_config) (if not using a `.nohost.me`/`noho.st`/`ynh.fr` domain){% if at_home %} and/or [port forwarding](/isp_box_config){% endif %}. !!! N.B. : **don't run away** ! The first time you run the diagnosis, it is quite expected to see a bunch of yellow/red alerts because you typically need to [configure DNS records](/dns_config) (if not using a `.nohost.me`/`noho.st`/`ynh.fr` domain), add a swapfile if not enough ram {% if at_home %} and/or [port forwarding](/isp_box_config){% endif %}.
!!! If an alert is not relevant (for example because you don't intend on using a specific feature), it is perfectly fine to flag the issue as 'ignored' by going in the webadmin > Diagnosis, and clicking the ignore button for this specifc issue. !!! If an alert is not relevant (for example because you don't intend on using a specific feature), it is perfectly fine to flag the issue as 'ignored' by going in the webadmin > Diagnosis, and clicking the ignore button for this specifc issue.

View file

@ -17,7 +17,7 @@ Si votre but est d'avoir un serveur de production :
- soyez conscient qu'un serveur est un système fragile : restez prudent, méthodique et patient ; - soyez conscient qu'un serveur est un système fragile : restez prudent, méthodique et patient ;
- limitez les expérimentations et la personnalisation - notamment des fichiers de config ; - limitez les expérimentations et la personnalisation - notamment des fichiers de config ;
- n'installez pas des douzaines d'applications juste pour voir de quoi elles ont l'air ; - n'installez pas des douzaines d'applications juste pour voir de quoi elles ont l'air ;
- utilisez les applications non-officielles avec prudence, et interdisez vous d'utiliser celles 'in progress', 'not working' ou qui on un niveau 0 ; - utilisez les applications non-officielles avec prudence, et interdisez-vous d'utiliser celles 'in progress', 'not working' ou qui on un niveau 0 ;
- si quelque chose casse, réfléchissez à deux fois avant de tenter de le réparer vous-même si vous ne savez pas ce que vous faites. <small>(Par exemple, n'essayez pas de recréer vous-même l'utilisateur admin juste parce qu'il a mystérieusement disparu...)</small> - si quelque chose casse, réfléchissez à deux fois avant de tenter de le réparer vous-même si vous ne savez pas ce que vous faites. <small>(Par exemple, n'essayez pas de recréer vous-même l'utilisateur admin juste parce qu'il a mystérieusement disparu...)</small>
## Keep it simple ! ## Keep it simple !
@ -35,7 +35,7 @@ Gardez les choses aussi simples que possible !
Certaines personnes ont tendance à tomber dans la "spirale de la réinstallation" - où chaque fois que quelque chose casse dans le serveur et qu'il n'est pas évident comment le réparer, ou parce que le serveur est devenu "sale", l'administrateur finit par réinstaller le serveur entier à partir de zéro car cela semble une solution "facile" et rapide pour remettre les choses à plat. Certaines personnes ont tendance à tomber dans la "spirale de la réinstallation" - où chaque fois que quelque chose casse dans le serveur et qu'il n'est pas évident comment le réparer, ou parce que le serveur est devenu "sale", l'administrateur finit par réinstaller le serveur entier à partir de zéro car cela semble une solution "facile" et rapide pour remettre les choses à plat.
Ne faites pas ça. La réinstallation est une opération lourde et n'est pas une bonne stratégie à long terme pour résoudre les problèmes. Vous vous fatiguerez et n'apprendrez rien. Oubliez le rêve d'avoir un serveur "propre" : un serveur de la vraie vie fini toujours par être "sale". De plus, vous devez apprendre (progressivement) à résoudre les problèmes lorsque vous les rencontrez. [Demandez de l'aide](/help) en fournissant des détails sur les symptômes, ce que vous essayez de faire et de ce qu'il se passe, et corrigez les problèmes. Avec le temps, vous aurez un bien meilleur contrôle sur votre serveur plutôt que réinstaller aveuglément à chaque fois. Ne faites pas ça. La réinstallation est une opération lourde et n'est pas une bonne stratégie à long terme pour résoudre les problèmes. Vous vous fatiguerez et n'apprendrez rien. Oubliez le rêve d'avoir un serveur "propre" : un serveur de la vraie vie finit toujours par être "sale". De plus, vous devez apprendre (progressivement) à résoudre les problèmes lorsque vous les rencontrez. [Demandez de l'aide](/help) en fournissant des détails sur les symptômes, ce que vous essayez de faire et de ce qu'il se passe, et corrigez les problèmes. Avec le temps, vous aurez un bien meilleur contrôle sur votre serveur plutôt que réinstaller aveuglément à chaque fois.
## Faites des sauvegardes ## Faites des sauvegardes
@ -47,7 +47,7 @@ En tant qu'administrateur, vous devriez configurer un client de messagerie pour
## YunoHost est un logiciel gratuit, maintenu par des bénévoles. ## YunoHost est un logiciel gratuit, maintenu par des bénévoles.
Enfin, gardez à l'esprit que YunoHost est un logiciel libre maintenu par des volontaires - et que le but de YunoHost (démocratiser l'auto-hébergement) n'est pas simple ! Le logiciel n'est fourni sans aucune garantie. L'équipe de bénévoles fait de son mieux pour maintenir et fournir la meilleure expérience possible - pourtant les fonctionnalités, les applications et YunoHost dans son ensemble sont loin d'être parfaits et vous ferez face tôt ou tard à de petit ou gros problèmes. Lorsque cela se produit, venez gentiment [demander de l'aide sur le chat ou le forum, ou signaler le problème](/help) :) ! Enfin, gardez à l'esprit que YunoHost est un logiciel libre maintenu par des volontaires - et que le but de YunoHost (démocratiser l'auto-hébergement) n'est pas simple ! Le logiciel est fourni sans aucune garantie. L'équipe de bénévoles fait de son mieux pour maintenir et fournir la meilleure expérience possible - pourtant les fonctionnalités, les applications et YunoHost dans son ensemble sont loin d'être parfaits et vous ferez face tôt ou tard à de petit ou gros problèmes. Lorsque cela se produit, venez gentiment [demander de l'aide sur le chat ou le forum, ou signaler le problème](/help) :) !
Si vous aimez YunoHost et que vous voulez que le projet soit maintenu en vie et progresse, n'hésitez pas à laisser une note de remerciement et à [faire un don](https://liberapay.com/YunoHost) au projet et à en parler autour de vous ! Si vous aimez YunoHost et que vous voulez que le projet soit maintenu en vie et progresse, n'hésitez pas à laisser une note de remerciement et à [faire un don](https://liberapay.com/YunoHost) au projet et à en parler autour de vous !

View file

@ -39,8 +39,11 @@ Par défaut, lauthentification SSH se fait avec le mot de passe dadministr
```bash ```bash
ssh-keygen ssh-keygen
ssh-copy-id -i ~/.ssh/id_rsa.pub <votre_serveur_yunohost> ssh-copy-id -i ~/.ssh/id_rsa.pub <nom_utilisateur@otre_serveur_yunohost>
``` ```
!!! Si vous avez des problèmes de permissions, donnez à `nom_utilisateur` la possession du dossier `~/.ssh` avec `chown`. Attention, pour des raisons de sécurité, ce dossier doit être en mode 700 !
!!! Si vous êtes sur Ubuntu 16.04 vous devez faire `ssh-add` pour initialiser l'agent ssh !!! Si vous êtes sur Ubuntu 16.04 vous devez faire `ssh-add` pour initialiser l'agent ssh
Entrez le mot de passe dadministration et votre clé publique devrait être copiée sur votre serveur. Entrez le mot de passe dadministration et votre clé publique devrait être copiée sur votre serveur.

View file

@ -33,8 +33,9 @@ By default, the SSH authentication uses the administration password. Deactivatin
```bash ```bash
ssh-keygen ssh-keygen
ssh-copy-id -i ~/.ssh/id_rsa.pub <your_yunohost_server> ssh-copy-id -i ~/.ssh/id_rsa.pub <username@your_yunohost_server>
``` ```
!!! If you meet permissions issues, set `username` as owner of the dir `~/.ssh` with `chown`. Be careful, for security reason this directory should be in mode `700`.
Type your admnistration password and your key will be copied on your server. Type your admnistration password and your key will be copied on your server.

View file

@ -30,7 +30,7 @@ A "no" may cause problems for using your server or may require you to make addit
| BT Internet | Yes | - | Yes| - | - | No | | BT Internet | Yes | - | Yes| - | - | No |
| Virgin Media | Yes | - | - | - | No | No | | Virgin Media | Yes | - | - | - | No | No |
| ZEN Internet | Yes | - | Yes | - | Yes | - | | ZEN Internet | Yes | - | Yes | - | Yes | - |
| PlusNet | Yes | Yes | Yes | No | - | Small one off Charge | | PlusNet | Yes | Yes | Yes | No | Yes, if you raise a ticket | Small one off Charge |
### Brazil ### Brazil
| Service provider | Box (modem/router) | uPnP available | Port 25 openable | [Hairpinning](http://en.wikipedia.org/wiki/Hairpinning) | Customizable reverse DNS | Fix IP | | Service provider | Box (modem/router) | uPnP available | Port 25 openable | [Hairpinning](http://en.wikipedia.org/wiki/Hairpinning) | Customizable reverse DNS | Fix IP |

View file

@ -19,15 +19,15 @@ Installez le programme et lancez *Filezilla*.
## Configuration ## Configuration
1. Cliquez sur l'icône *Gestionnaire de Sites* en haut à gauche de sorte à crééer une configuration utilisable ultérieurement. 1. Cliquez sur l'icône *Gestionnaire de Sites* en haut à gauche de sorte à créer une configuration utilisable ultérieurement.
![écran principal de Filezilla](image://filezilla_1.png) ![écran principal de Filezilla](image://filezilla_1.png)
2. Cliquez sur **Nouveau site** et donnez un nom au serveur que vous allez utiliser. Par exemple "Famille". Remplissez les paramètres comme sur la capture d'écran (en remplaçant l'adresse du serveur par la votre). Une fois terminé, cliquez sur **Connexion**. (N.B. : si vous souhaitez éditer les fichiers de l'application [custom webapp](https://github.com/YunoHost-Apps/my_webapp_ynh), il vous faudra utiliser un autre utilisateur que admin. Se référer à la documentation de custom webapp.) 2. Cliquez sur **Nouveau site** et donnez un nom au serveur que vous allez utiliser. Par exemple "Famille". Remplissez les paramètres comme sur la capture d'écran (en remplaçant l'adresse du serveur par la vôtre). Une fois terminé, cliquez sur **Connexion**. (N.B. : si vous souhaitez éditer les fichiers de l'application [custom webapp](https://github.com/YunoHost-Apps/my_webapp_ynh), il vous faudra utiliser un autre utilisateur que admin. Se référer à la documentation de custom webapp.)
![écran du gestionnaire de site](image://filezilla_2.png) ![écran du gestionnaire de site](image://filezilla_2.png)
3. Vous recevrez un avertissement. *Vous pouvez l'ignorer si il s'agit de la première connexion*. 3. Vous recevrez un avertissement. *Vous pouvez l'ignorer s'il s'agit de la première connexion*.
![avertissement au sujet de l'empreinte inconnue du serveur](image://filezilla_3.png) ![avertissement au sujet de l'empreinte inconnue du serveur](image://filezilla_3.png)
@ -35,7 +35,7 @@ Installez le programme et lancez *Filezilla*.
![écran d'identification demandant le mot de passe](image://filezilla_4.png) ![écran d'identification demandant le mot de passe](image://filezilla_4.png)
5. Une fois cette configuration créée, elle sera réutilisable les fois suivanteS. 5. Une fois cette configuration créée, elle sera réutilisable les fois suivantes.
![la vue du "gestionnaire de site" avec le nouveau serveur ajouté](image://filezilla_5.png) ![la vue du "gestionnaire de site" avec le nouveau serveur ajouté](image://filezilla_5.png)

View file

@ -42,7 +42,7 @@ mmcblk0 179:0 0 14.9G 0 disk
└─mmcblk0p2 179:2 0 14.8G 0 part / └─mmcblk0p2 179:2 0 14.8G 0 part /
``` ```
Ici, `mmcblk0` corresponds à une carte SD de 16Go (on voit que les partitions `mmcblk0p1` et `mmcblk0p2` correspondent à la partition de démarrage `/boot` et à la partition système `/`). Le disque dur branché correspond à `sda` qui fait environ 1To, et contient une seule partition `sda1` qui n'est pas monté (pas de "MOUNTPOINT"). Ici, `mmcblk0` correspond à une carte SD de 16Go (on voit que les partitions `mmcblk0p1` et `mmcblk0p2` correspondent à la partition de démarrage `/boot` et à la partition système `/`). Le disque dur branché correspond à `sda` qui fait environ 1To, et contient une seule partition `sda1` qui n'est pas monté (pas de "MOUNTPOINT").
! [fa=exclamation-triangle /] Sur un autre système, il se peut que votre système soit installé sur `sda` et que votre disque soit alors `sdb` par exemple. ! [fa=exclamation-triangle /] Sur un autre système, il se peut que votre système soit installé sur `sda` et que votre disque soit alors `sdb` par exemple.
@ -76,9 +76,9 @@ mkfs.ext4 /dev/VOTRE_DISQUE1
## 3. Monter le disque ## 3. Monter le disque
"Monter" un disque corresponds à le rendre effectivement accessible dans l'arborescence des fichiers. Nous allons choisir arbitrairement de monter le disque dans `/media/stockage` mais vous pouvez le nommer différement (par exemple `/media/mon_disque` ...). "Monter" un disque signifie le rendre effectivement accessible dans l'arborescence des fichiers. Nous allons choisir arbitrairement de monter le disque dans `/media/stockage` mais vous pouvez le nommer différemment (par exemple `/media/mon_disque` ...).
Commençons par cŕeer le répertoire : Commençons par cer le répertoire :
```bash ```bash
mkdir /media/stockage mkdir /media/stockage
``` ```
@ -89,7 +89,7 @@ Puis nous pouvons monter le disque manuellement avec :
mount /dev/VOTRE_DISQUE1 /media/stockage mount /dev/VOTRE_DISQUE1 /media/stockage
``` ```
(Ici, `/dev/VOTRE_DISQUE1` corresponds à la première partition sur le disque) (Ici, `/dev/VOTRE_DISQUE1` correspond à la première partition sur le disque)
Ensuite, vous devriez pouvoir créer des fichiers dans `/media/stockage`, et, par exemple, ajouter `/media/stockage` comme périphérique externe dans Nextcloud. Ensuite, vous devriez pouvoir créer des fichiers dans `/media/stockage`, et, par exemple, ajouter `/media/stockage` comme périphérique externe dans Nextcloud.

View file

@ -0,0 +1,58 @@
---
title: Ventajas de una VPN para el autoalojamiento
template: docs
taxonomy:
category: docs
routes:
default: '/vpn_advantage'
---
Dado que la instalación de un servidor en casa es una práctica poco habitual, la mayoría de las conexiones a Internet que se proporcionan a los particulares no son adecuadas para este fin. Una VPN de red neutra que proporcione una dirección IPv4 fija y direcciones IPv6 puede ayudar a superar algunas limitaciones o dificultades.
! <b>Advertencia</b>: no todos los proveedores de VPN existentes cumplen estos requisitos, asegúrese de que el que elija los cumpla.
## Ventajas
### Plug & Play
Configurando una VPN en tu servidor, podrás hacerlo accesible al resto de Internet sin tener que cambiar la configuración del router al que lo conectas. Esto puede ser realmente útil si te vas de vacaciones, te mudas de casa o si tienes un corte de Internet, porque podrás conectarlo fácilmente a una persona de confianza sin tener que configurar el router de la persona que te ayuda.
De la misma manera, te ahorrarás abrir los puertos de tu router, así como evitar el hairpinning.
### Sin microcortes DNS
Si su conexión a Internet no tiene una IP pública fija, se verá obligado a configurar un nombre de dominio dinámico (DNS dinámico). Esto puede ser aceptable, pero el DNS sólo se actualizará a intervalos regulares (cada dos minutos si es un nombre de dominio noho.st o nohost.me). Por lo tanto, existe la posibilidad de que ocasionalmente se produzcan errores de visualización en el navegador, o incluso que se muestre otro sitio (los riesgos se reducen, sin embargo, porque la práctica del autoalojamiento no está muy extendida).
Con una VPN neutra, este problema se sortea porque la VPN puede compararse con una Conexión Virtual a Internet, que tiene su propia dirección IPv4 fija, por lo que no es necesario actualizar el nombre de dominio.
### El caso del correo electrónico
El correo es uno de los protocolos más complejos de autoalojar, normalmente es lo último que autoaloja un usuario. De hecho, es muy fácil encontrarse en una situación en la que los correos electrónicos enviados por el servidor son rechazados por los servidores SMTP de los destinatarios.
Para evitarlo, necesitas, entre otras cosas:
-configurar el DNS inverso de la conexión a Internet del servidor (o VPN)
-una IPv4 fija
-que esta IPv4 sea eliminada de todas las listas negras (en particular, la IP no debe estar en el DUL)
-poder abrir el puerto 25 (así como otros puertos SMTP)
Desgraciadamente, ninguno de los ISP franceses más habituales respeta todos estos puntos.
Para superar esto, el uso de una VPN que respete estos puntos puede ser una alternativa.
### Confianza
Por último, si no quiere que el contenido de las comunicaciones de su servidor sea espiable por los equipos presentes en la red de su proveedor de servicios de Internet, puede utilizar una VPN para cifrar sus comunicaciones y deportar su confianza a un proveedor de VPN. A modo de recordatorio, desde 2015, el gobierno despliega oficialmente cajas negras en los principales operadores de red cuyo objetivo es espiar todas las comunicaciones digitales francesas para, entre otras cosas, preservar los intereses científicos, económicos e industriales de Francia.
## Desvenjajas
### Coste
Una VPN neutra tiene un coste, ya que el operador que la proporciona debe gestionar un servidor y utilizar el ancho de banda. Los precios de las VPN asociadas a FFDN rondan los 6 euros al mes.
### Enrutamiento de paquetes
Cuando se establece una VPN en el servidor, si no se establece una configuración particular, la transferencia de un archivo desde un ordenador de la red local al servidor que utiliza la VPN, pasará por el extremo de la VPN, es decir, por el servidor del proveedor de la VPN.
Para superar este punto, hay dos soluciones:
-transformando su servidor en un router y conectando su equipo doméstico a él, este equipo se beneficiará también de la confidencialidad de la VPN.
-utilizar el servidor de YunoHost como resolvedor de DNS cuando estés en casa, para redirigir los nombres de dominio del servidor a la ip local en lugar de la ip pública. Esta operación puede realizarse en cada dispositivo o en el router (si éste lo permite).

View file

@ -41,3 +41,5 @@ chmod g+rx /media/externalharddrive
(but it depends on your exact setup... Please update this doc page if you figure (but it depends on your exact setup... Please update this doc page if you figure
out what to do exactly) out what to do exactly)
!!! If you want to do it with *NextCloud*, see [this Tutorial](/app_nextcloud).

View file

@ -20,7 +20,7 @@ Grav est une plateforme Web rapide, simple et flexible, basée sur des fichiers.
## Liens utiles ## Liens utiles
+ Site web : [getgrav.org (en)](https://getgrav.org/) + Site web : [getgrav.org (en)](https://getgrav.org/)
+ Documentation officielle : [learn.getgrav.org (en)](https://learn.getgrav.org/16) + Documentation officielle : [learn.getgrav.org (en)](https://learn.getgrav.org/)
+ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/grav](https://github.com/YunoHost-Apps/grav_ynh) + Dépôt logiciel de l'application : [github.com - YunoHost-Apps/grav](https://github.com/YunoHost-Apps/grav_ynh)
+ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/grav/issues](https://github.com/YunoHost-Apps/grav_ynh/issues) + Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/grav/issues](https://github.com/YunoHost-Apps/grav_ynh/issues)

View file

@ -20,7 +20,7 @@ Grav is a Fast, Simple, and Flexible, file-based Web-platform. There is Zero ins
## Useful links ## Useful links
+ Website: [getgrav.org](https://getgrav.org/) + Website: [getgrav.org](https://getgrav.org/)
+ Official documentation: [learn.getgrav.org](https://learn.getgrav.org/16) + Official documentation: [learn.getgrav.org](https://learn.getgrav.org/)
+ Application software repository: [github.com - YunoHost-Apps/grav](https://github.com/YunoHost-Apps/grav_ynh) + Application software repository: [github.com - YunoHost-Apps/grav](https://github.com/YunoHost-Apps/grav_ynh)
+ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/grav/issues](https://github.com/YunoHost-Apps/grav_ynh/issues) + Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/grav/issues](https://github.com/YunoHost-Apps/grav_ynh/issues)

View file

@ -7,7 +7,7 @@ routes:
default: '/app_my_webapp' default: '/app_my_webapp'
--- ---
En complément du Readme.md de l'application, voici des astuces utiles. En complément du [Readme_fr.md](https://github.com/YunoHost-Apps/my_webapp_ynh/blob/testing/README_fr.md) de l'application, voici des astuces utiles.
## Mise à jour automatique du contenu du site. ## Mise à jour automatique du contenu du site.

View file

@ -7,7 +7,7 @@ routes:
default: '/app_my_webapp' default: '/app_my_webapp'
--- ---
In addition to the application's Readme.md, here are some useful tips. In addition to the application's [Readme.md](https://github.com/YunoHost-Apps/my_webapp_ynh/blob/testing/README.md), here are some useful tips.
## Automatic update of the site content ## Automatic update of the site content

View file

@ -71,6 +71,7 @@ You can [contribute to this list by adding something you'd like to be packaged](
| [EteSync](https://www.etesync.com/) | | [Upstream](https://github.com/etesync) | | | [EteSync](https://www.etesync.com/) | | [Upstream](https://github.com/etesync) | |
| [Ethercalc](https://ethercalc.net/) | Collaborative spreadsheet editor | | [Package Draft](https://github.com/YunoHost-Apps/ethercalc_ynh) | | [Ethercalc](https://ethercalc.net/) | Collaborative spreadsheet editor | | [Package Draft](https://github.com/YunoHost-Apps/ethercalc_ynh) |
| Facette | | | [Package Draft](https://github.com/YunoHost-Apps/facette_ynh) | | Facette | | | [Package Draft](https://github.com/YunoHost-Apps/facette_ynh) |
| [Federated wiki](http://fed.wiki.org/view/welcome-visitors/view/federated-wiki) | Farm for fedwiki sites | [Upstream](https://github.com/fedwiki) | |
| [Ferdi server](https://getferdi.com) | Messaging aggregation | [Upstream](https://github.com/getferdi/server) | | | [Ferdi server](https://getferdi.com) | Messaging aggregation | [Upstream](https://github.com/getferdi/server) | |
| [FEX](https://fex.rus.uni-stuttgart.de/) | | | | | [FEX](https://fex.rus.uni-stuttgart.de/) | | | |
| [Filestash](https://www.filestash.app/) | | [Upstream](https://github.com/mickael-kerjean/filestash) | | | [Filestash](https://www.filestash.app/) | | [Upstream](https://github.com/mickael-kerjean/filestash) | |
@ -139,6 +140,7 @@ You can [contribute to this list by adding something you'd like to be packaged](
| [LibreOffice Online](https://www.libreoffice.org/download/libreoffice-online/) | | | | | [LibreOffice Online](https://www.libreoffice.org/download/libreoffice-online/) | | | |
| linuxdash | Low-overhead monitoring web dashboard | [Upstream](https://github.com/afaqurk/linux-dash) | [Package Draft](https://github.com/YunoHost-Apps/linuxdash_ynh) | | linuxdash | Low-overhead monitoring web dashboard | [Upstream](https://github.com/afaqurk/linux-dash) | [Package Draft](https://github.com/YunoHost-Apps/linuxdash_ynh) |
| [LiquidSoap](https://www.liquidsoap.info/) | Audio and video streaming language | [Upstream](https://github.com/savonet/liquidsoap) | | | [LiquidSoap](https://www.liquidsoap.info/) | Audio and video streaming language | [Upstream](https://github.com/savonet/liquidsoap) | |
| [listmonk](https://listmonk.app) | Self-hosted newsletter & mailing list manager | [Upstream](https://github.com/knadh/listmonk) | |
| LocomotiveCMS | | [Upstream](https://github.com/locomotivecms/engine) | | | LocomotiveCMS | | [Upstream](https://github.com/locomotivecms/engine) | |
| [Loki](https://docs.loki.network/ServiceNodes/DebianPackageGuide/)| Service node for the Loki Network | [Upstream](https://github.com/loki-project/) | | | [Loki](https://docs.loki.network/ServiceNodes/DebianPackageGuide/)| Service node for the Loki Network | [Upstream](https://github.com/loki-project/) | |
| [Loomio](https://www.loomio.org) | | [Upstream](https://github.com/loomio/loomio/) | | | [Loomio](https://www.loomio.org) | | [Upstream](https://github.com/loomio/loomio/) | |
@ -150,6 +152,7 @@ You can [contribute to this list by adding something you'd like to be packaged](
| mediadrop | Video Platform | | [Package Draft](https://github.com/YunoHost-Apps/mediadrop_ynh) | | mediadrop | Video Platform | | [Package Draft](https://github.com/YunoHost-Apps/mediadrop_ynh) |
| [Mediagoblin](https://mediagoblin.org/) | Video streaming platform | [Upstream](https://savannah.gnu.org/projects/mediagoblin) | | | [Mediagoblin](https://mediagoblin.org/) | Video streaming platform | [Upstream](https://savannah.gnu.org/projects/mediagoblin) | |
| [medusa](https://pymedusa.com/) | Automatic TV shows downloader | | [Package Draft](https://github.com/guigot/medusa_ynh) | | [medusa](https://pymedusa.com/) | Automatic TV shows downloader | | [Package Draft](https://github.com/guigot/medusa_ynh) |
| [Megaglest](https://megaglest.org/) | realtime stategy game | [Upstream](https://megaglest.org/linux-packages.html) | |
| microblog.pub | | [Upstream](https://github.com/tsileo/microblog.pub) | | | microblog.pub | | [Upstream](https://github.com/tsileo/microblog.pub) | |
| miniflux | Minimal RSS reader | | [Package Draft](https://github.com/mat-mo/miniflux_ynh) | | miniflux | Minimal RSS reader | | [Package Draft](https://github.com/mat-mo/miniflux_ynh) |
| [Mirakel](https://mirakel.azapps.de/taskwarrior.html) | | [Upstream](https://github.com/GothenburgBitFactory/taskwarrior) | | | [Mirakel](https://mirakel.azapps.de/taskwarrior.html) | | [Upstream](https://github.com/GothenburgBitFactory/taskwarrior) | |

View file

@ -27,11 +27,11 @@ Classement des applications disponibles par tags (genre, Git, gestion associatio
2. Une partie configuration de l'application. 2. Une partie configuration de l'application.
1. Une partie administration de l'application. 1. Une partie administration de l'application.
1. Une partie sur les limitations liées à YunoHost. 1. Une partie sur les limitations liées à YunoHost.
1. Une partie sur les clients desktop (si il en existe). Lien vers différentes applications tierces si il en existe plusieurs (lien possible avec le catalogue d'applications [framalibre.org](https://framalibre.org)) ou un lien vers la page concernant les applications desktop si des applications officielles sont fournies. 1. Une partie sur les clients desktop (s'il en existe). Lien vers différentes applications tierces s'il en existe plusieurs (lien possible avec le catalogue d'applications [framalibre.org](https://framalibre.org)) ou un lien vers la page concernant les applications desktop si des applications officielles sont fournies.
1. Une partie avec : 1. Une partie avec :
- le lien vers le site officiel - le lien vers le site officiel
- le lien vers la documentation officielle - le lien vers la documentation officielle
- Les liens vers le package de YunoHost et issues - les liens vers le package de YunoHost et issues
Trame pour la rédaction des pages de documentations : [ici](/app_writing_guide) Trame pour la rédaction des pages de documentations : [ici](/app_writing_guide)
@ -39,5 +39,5 @@ Trame pour la rédaction des pages de documentations : [ici](/app_writing_guide)
1. Documenter les applications. 1. Documenter les applications.
1. Documenter les applications au travail (marqué : work) niveau 8/7/6. 1. Documenter les applications au travail (marqué : work) niveau 8/7/6.
1. Traduire la page de documentation à minima en français et en anglais. 1. Traduire la page de documentation a minima en français et en anglais.
1. Faire une PR sur le dépôt de l'application concernée vers la page de documentation. 1. Faire une PR sur le dépôt de l'application concernée vers la page de documentation.

View file

@ -85,9 +85,9 @@ Le fichier `manifest.json` définit les constantes de lapplication, un ensemb
* **arguments** : * **arguments** :
* **install** : paramètres à demander à ladministrateur lors de linstallation. * **install** : paramètres à demander à ladministrateur lors de linstallation.
* **name** : identifiant du paramètre * **name** : identifiant du paramètre
* **type** : (optionnel) type de paramètre parmis `domain`, `path`, `user`, `app`, `boolean`, `string` et `password`. Le champ sera caché dans le cas dun mot de passe. * **type** : (optionnel) type de paramètre parmi `domain`, `path`, `user`, `app`, `boolean`, `string` et `password`. Le champ sera caché dans le cas dun mot de passe.
* **choices** : (optionnel) restreint les réponses possibles à plusieurs choix. * **choices** : (optionnel) restreint les réponses possibles à plusieurs choix.
* **optional** : (optionnel) champs qui indique si ce paramètre est optionnel. Il peut avoir les valeurs `true` ou `false`. * **optional** : (optionnel) champ qui indique si ce paramètre est optionnel. Il peut avoir les valeurs `true` ou `false`.
* **ask** : question posée (au minimum en anglais `en`) que vous pouvez traduire dans plusieurs langues. * **ask** : question posée (au minimum en anglais `en`) que vous pouvez traduire dans plusieurs langues.
* **example** : (optionnel) valeur dexemple pour aider ladministrateur à remplir le formulaire dinstallation. * **example** : (optionnel) valeur dexemple pour aider ladministrateur à remplir le formulaire dinstallation.
* **default** : (optionnel) valeur par défaut. * **default** : (optionnel) valeur par défaut.

View file

@ -22,15 +22,15 @@ Il est possible d'utiliser des helpers et d'importer une librairie de fonction p
Cette variable contient le chemin du répertoire de travail courant du contexte d'exécution du script. Elle peut être utile pour retrouver le chemin initial si on s'est déplacé pendant l'exécution du script. Elle est utilisée par certains helpers pour être sûr d'utiliser le bon. Cette variable contient le chemin du répertoire de travail courant du contexte d'exécution du script. Elle peut être utile pour retrouver le chemin initial si on s'est déplacé pendant l'exécution du script. Elle est utilisée par certains helpers pour être sûr d'utiliser le bon.
#### YNH_APP_ID #### YNH_APP_ID
Contient l'identifiant de l'application sans le numéro d'instance Contient l'identifiant de l'application sans le numéro d'instance.
Exemple: strut Exemple: strut
#### YNH_APP_INSTANCE_NAME #### YNH_APP_INSTANCE_NAME
Contient le nom d'instance qui sera utilisé dans de nombreuses situation pour pouvoir gérer l'installation multiple d'une même app. Contient le nom d'instance qui sera utilisé dans de nombreuses situations pour pouvoir gérer l'installation multiple d'une même app.
Exemple: strut__3 Exemple: strut__3
#### YNH_APP_INSTANCE_NUMBER #### YNH_APP_INSTANCE_NUMBER
Contient le numéro de l'instance. Attention il ne s'agit pas forcément du nombre d'instance toujours installée, car une ancienne application peut avoir été désinstallée. Contient le numéro de l'instance. Attention il ne s'agit pas forcément du nombre d'instances toujours installées, car une ancienne application peut avoir été désinstallée.
Exemple: 3 Exemple: 3

View file

@ -36,9 +36,9 @@ Après l'effacement de toute les règles d'accès sur une application.
- `post_app_install` - `post_app_install`
Après l'installation d'une application. Après l'installation d'une application.
- `post_app_upgrade` - `post_app_upgrade`
Après l'upgrade d'une applications. Après l'upgrade d'une application.
- `post_app_remove` - `post_app_remove`
Après la supression d'une applications. Après la supression d'une application.
- `post_app_change_url` - `post_app_change_url`
Après avoir modifié le chemin et/ou le nom de domaine d'une application. Après avoir modifié le chemin et/ou le nom de domaine d'une application.
- `post_cert_update` - `post_cert_update`
@ -66,13 +66,13 @@ Services pris en charge par `regen-conf` :
À l'exception du hook `conf_regen`, tout les hooks s'utilisent de la même manière. À l'exception du hook `conf_regen`, tout les hooks s'utilisent de la même manière.
Tout d'abord, il faut comprendre qu'un hook est un simple script bash qui sera exécuté par YunoHost lorsque l'évènement indiqué se présentera. Tout d'abord, il faut comprendre qu'un hook est un simple script bash qui sera exécuté par YunoHost lorsque l'évènement indiqué se présentera.
Pour ajouter un hook à YunoHost, il faut utiliser un dossier "hooks" à la racine du package de l'application. Puis dans celui-ci mettre votre script sous le nom du hooks correspondant. Pour ajouter un hook à YunoHost, il faut utiliser un dossier "hooks" à la racine du package de l'application. Puis dans celui-ci mettre votre script sous le nom du hook correspondant.
> Par exemple : > Par exemple :
Pour un hook `post_user_create`, le script qui devra être exécuté pour ce hook doit simplement être placé dans `hooks/post_user_create` dans le package. Pour un hook `post_user_create`, le script qui devra être exécuté pour ce hook doit simplement être placé dans `hooks/post_user_create` dans le package.
Lors de l'installation et de l'upgrade, les scripts dans le dossier hooks seront dupliqués dans le dossier `/etc/yunohost/hooks.d/` dans le dossier correspondant au hook, puis sous le nom `50-$app`. Lors de l'installation et de l'upgrade, les scripts dans le dossier hooks seront dupliqués dans le dossier `/etc/yunohost/hooks.d/` dans le dossier correspondant au hook, puis sous le nom `50-$app`.
Lors de la suppression de l'application, tout les hooks lui appartenant seront supprimés. Lors de la suppression de l'application, tous les hooks lui appartenant seront supprimés.
### Construire un script de hook ### Construire un script de hook
@ -125,7 +125,7 @@ backup_name=$1
Les variables utilisables dans ces scripts sont les mêmes que celles disponibles dans [les scripts d'actions associés](/packaging_apps_scripts). Les variables utilisables dans ces scripts sont les mêmes que celles disponibles dans [les scripts d'actions associés](/packaging_apps_scripts).
Example : pour `post_app_install` les variables sont les mêmes que pour le script `install` Exemple : pour `post_app_install` les variables sont les mêmes que pour le script `install`
##### `post_app_addaccess` et `post_app_removeaccess` ##### `post_app_addaccess` et `post_app_removeaccess`
@ -162,7 +162,7 @@ cp hook_regen_conf /usr/share/yunohost/hooks/conf_regen/50-SERVICE_$app
##### Construire un script de hook conf_regen ##### Construire un script de hook conf_regen
Un hook `conf_regen` est appelé 2 fois, une première fois après analyse de la configuration et avant une éventuelle modification des fichiers, puis une seconde fois après application des modifications, si il y a eu des modifications. Un hook `conf_regen` est appelé 2 fois, une première fois après analyse de la configuration et avant une éventuelle modification des fichiers, puis une seconde fois après application des modifications, s' il y a eu des modifications.
Un script de hook `conf_regen` devrait donc ressembler à ça : Un script de hook `conf_regen` devrait donc ressembler à ça :