From 044668b843b20cb3825be13bad18d026c0f0273a Mon Sep 17 00:00:00 2001 From: Jaxom99 <30865395+Jaxom99@users.noreply.github.com> Date: Tue, 15 Oct 2019 23:03:05 +0200 Subject: [PATCH 1/5] Update dns_config_fr.md add NB to avoid confusion with "domain.tld" --- dns_config_fr.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/dns_config_fr.md b/dns_config_fr.md index 85038f10..ccba7b95 100644 --- a/dns_config_fr.md +++ b/dns_config_fr.md @@ -13,6 +13,7 @@ la configuration devrait être faite automatiquement. Si vous utilisez votre pro domaine via l'interface de votre registrar. ## Configuration DNS recommandée +NB : les exemples utilisent ici le texte `votre.domain.tld`, à remplacer par votre domaine (par exemple `www.yunohost.org`). YunoHost fournit une configuration DNS recommandée, accessible via : - la webadmin, dans Domaines > votre.domain.tld > Configuration DNS ; @@ -74,9 +75,9 @@ suivante : #### Quelques notes à propos de cette table -- 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 ;) ; - `@` corresponds à `votre.domaine.tld`, et par ex. `muc` corresponds à `muc.votre.domaine.tld` ; -- Les valeurs montrées 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 ; - 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. From dde9f06cc6981b1d2e41a172b97b0d83ff2f22c5 Mon Sep 17 00:00:00 2001 From: Jaxom99 <30865395+Jaxom99@users.noreply.github.com> Date: Tue, 15 Oct 2019 23:07:28 +0200 Subject: [PATCH 2/5] Update dns_config.md add explanation of placeholder, to avoid typos and confusion --- dns_config.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/dns_config.md b/dns_config.md index c19c9f3b..6c331a83 100644 --- a/dns_config.md +++ b/dns_config.md @@ -5,22 +5,23 @@ DNS (domain name system) is a system that converts human-readable addresses easily accessible by human beings, and for some services like mail to work properly, DNS must be configured. -If you're using an [automatic domain](/dns_nohost_me) provided by the YunoHost Project, the configuration should be +If you're using a nohost.me / noho.st / ynh.fr domain, the configuration should be performed automatically. If you're using your own domain name (e.g. bought via a registrar), you should manually configure your domain on your registrar's interface. ## Recommended DNS configuration +NB: Examples here use the placeholder `your.domain.tld`, you have to replace it with your real domain, such as `www.yunohost.org`. YunoHost provides a recommended DNS configuration, available via : - the webadmin, in Domain > your.domain.tld > DNS configuration ; - or the command line, `yunohost domain dns-conf your.domain.tld` For specific needs or specific setups, and if you know what you're doing, you -might want or have to tweak these or add additional ones (e.g. to handle +might want or have to tweak these, or add additional ones (e.g. to handle subdomains). -The recommended configuration typically looks like this : +The recommended configuration typically looks like this: ```bash # @@ -51,7 +52,7 @@ mail._domainkey 3600 IN TXT "v=DKIM1; k=rsa; p=someHuuuuuuugeKey" _dmarc 3600 IN TXT "v=DMARC1; p=none" ``` -Though it might be easier to understand it if displayed like this : +Though it might be easier to understand it if displayed like this: | Type | Name | Value | @@ -76,7 +77,5 @@ Though it might be easier to understand it if displayed like this : - The dot at the end of `your.domain.tld.` is important ;) ; - `@` corresponds to `your.domain.tld`, and e.g. `muc` corresponds to `muc.your.domain.tld` ; - These are example values ! See your generated conf for the actual values you should use ; -- We recommend a [TTL](https://en.wikipedia.org/wiki/Time_to_live#DNS_records) of 3600 (1 hour). But you can use something else if you - know what you're doing ; -- Don't put an IPv6 record if you're not sure IPv6 really works on your server ! - You might have issues with Let's Encrypt if it doesn't. +- We recommend a [TTL](https://en.wikipedia.org/wiki/Time_to_live#DNS_records) of 3600 (1 hour). But you can use something else if you know what you're doing ; +- Don't put an IPv6 record if you're not sure IPv6 really works on your server! You might have issues with Let's Encrypt if it doesn't. From 44b8999f12dac50e928919d5082bcb04df7c8cfd Mon Sep 17 00:00:00 2001 From: Jaxom99 <30865395+Jaxom99@users.noreply.github.com> Date: Tue, 15 Oct 2019 23:09:55 +0200 Subject: [PATCH 3/5] Update dns_config.md restore automatic domain link --- dns_config.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dns_config.md b/dns_config.md index 6c331a83..8dcee614 100644 --- a/dns_config.md +++ b/dns_config.md @@ -5,7 +5,7 @@ DNS (domain name system) is a system that converts human-readable addresses easily accessible by human beings, and for some services like mail to work properly, DNS must be configured. -If you're using a nohost.me / noho.st / ynh.fr domain, the configuration should be +If you're using an [automatic domain](/dns_nohost_me) provided by the YunoHost Project, the configuration should be performed automatically. If you're using your own domain name (e.g. bought via a registrar), you should manually configure your domain on your registrar's interface. From a0ba3acac9ca88d96bdfa73fe1e7c9a2a1b4bedc Mon Sep 17 00:00:00 2001 From: Jaxom99 <30865395+Jaxom99@users.noreply.github.com> Date: Tue, 15 Oct 2019 23:14:08 +0200 Subject: [PATCH 4/5] Update dns_config_es.md add placeholder example --- dns_config_es.md | 1 + 1 file changed, 1 insertion(+) diff --git a/dns_config_es.md b/dns_config_es.md index 879ed0e6..87797baf 100644 --- a/dns_config_es.md +++ b/dns_config_es.md @@ -6,6 +6,7 @@ Si utilizas un [dominio automático](/dns_nohost_me_es) provecho por el Proyecto ## Configuración DNS recomendada +_Nota: los ejemplos utilizan el marcador `tu.dominio.tld`, debe ser reemplazado por su propio dominio, como `www.yunohost.org`._ YunoHost provee una configuración DNS recomendada, accesible vía : - la webadmin, en Dominios > tu.dominio.tld > Configuración DNS ; From 312c83a81bf9612c7785ec5b1ed44895e1d5899c Mon Sep 17 00:00:00 2001 From: Jaxom99 <30865395+Jaxom99@users.noreply.github.com> Date: Tue, 15 Oct 2019 23:15:16 +0200 Subject: [PATCH 5/5] Update dns_config_fr.md typo + italique --- dns_config_fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dns_config_fr.md b/dns_config_fr.md index ccba7b95..b6420b3f 100644 --- a/dns_config_fr.md +++ b/dns_config_fr.md @@ -13,7 +13,7 @@ la configuration devrait être faite automatiquement. Si vous utilisez votre pro domaine via l'interface de votre registrar. ## Configuration DNS recommandée -NB : les exemples utilisent ici le texte `votre.domain.tld`, à remplacer par votre domaine (par exemple `www.yunohost.org`). +_NB : les exemples utilisent ici le texte `votre.domaine.tld`, à remplacer par votre propre domaine (par exemple `www.yunohost.org`)._ YunoHost fournit une configuration DNS recommandée, accessible via : - la webadmin, dans Domaines > votre.domain.tld > Configuration DNS ;