From f4d94c9f57a681863db0ae4aa7b0174d366dde41 Mon Sep 17 00:00:00 2001
From: Julien Osman <33510663+jershon@users.noreply.github.com>
Date: Fri, 5 Oct 2018 16:51:16 +0200
Subject: [PATCH] Translation to english of dns_subdomains_fr.md

---
 dns_subdomains.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 dns_subdomains.md

diff --git a/dns_subdomains.md b/dns_subdomains.md
new file mode 100644
index 00000000..8f0b5a35
--- /dev/null
+++ b/dns_subdomains.md
@@ -0,0 +1,39 @@
+## DNS and subdomains for the applications
+
+### Subdomains
+
+YunoHost allows the use of subdomains. If one owns a domain name `mydomain.com`, one first needs to create the subdomains in the DNS configuration (with one's registrar like Gandi).
+
+### Configuration example with Gandi
+
+The DNS configuration needs an A record with an IPv4 address, an AAAA record with an IPv6 address, and various CNAME records, one for each desired subdomain.
+
+If your DNS configuration looks like:
+```bash
+@         A            XYZ.XYZ.XYZ.XYZ
+@         AAAA         1234:1234:1234:FFAA:FFAA:FFAA:FFAA:AAFF
+*         CNAME        mydomain.com.
+agenda    CNAME        mydomain.com.
+blog      CNAME        mydomain.com.
+rss       CNAME        mydomain.com.
+```
+then you can access `agenda.mydomain.com`, `blog.mydomain.com` and `rss.mydomain.com` subdomains.
+
+### Install an application on a subdomain
+
+To install an application on a subdomain in YunoHost, for example `blog.mydomain.com`, the configuration is done in the administration panel. One first add the subdomain to the available domains list. The creation of a subdomain in Yunohost will create the corresponding configuration files  for Nginx (the web server used in YunoHost).
+
+Then, in the applications>install panel, one follows the classic installation process by choosing the desired subdomain as domain (for example `blog.mydomain.com`). One needs to choose the path `/` (in place of `/wordpress` for example). A warning message will appear telling that it won't be possible to install other application to this subdomain. After validation, the installation starts.
+
+The application is then available at `blog.mydomain.com` (and not `mydomain.com/wordpress`).
+
+### Moving an application to a subdomain
+
+What happens if the application is already installed? For example, one wants to move `mydomain.com/wordpress` to `blog.mydomain.com`.
+It depends on the application. 
+Some applications allow the change of domain. In that case, one can proceed to the change through the administration panel Applications>the_app>change URL. 
+If the application doesn't allow URL change, then there is no easy way to do it. The best solution is to reinstall the application.
+
+### Reinstalling an application
+
+First, save the application data through the backup process. Then uninstall the application with the administration panel. Then reinstall the application to the desired domain. Finally, restore the backup.