YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

Translation to english of dns_subdomains_fr.md

Browse source
This commit is contained in:
Julien Osman 2018-10-05 16:51:16 +02:00 committed by GitHub
parent d890a0679c
commit f4d94c9f57
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 39 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

39
dns_subdomains.md Normal file
View file

@ -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.