doc/pages/01.administrate/05.advance/01.domains/01.dns_nohost_me/dns_nohost.me.md

63 lines
2.8 KiB
Markdown
Raw Normal View History

2020-11-11 11:47:10 +01:00
---
title: Nohost.me domains
template: docs
taxonomy:
category: docs
---
2019-01-03 18:24:39 +01:00
2020-09-20 10:57:13 +02:00
In order to make self-hosting as accessible as possible, the YunoHost Project provides a *free* and *automatically configured* domain name service. By using this service, you won't have to [configure DNS records](/dns_config) yourself, which can be tedious and technical.
2019-01-03 18:24:39 +01:00
The following (sub)domains are proposed:
- `whateveryouwant.nohost.me`;
- `whateveryouwant.noho.st`;
- `whateveryouwant.ynh.fr`.
2020-09-20 10:57:13 +02:00
To use this service, you simply have to choose such a domain during the post-installation. It will then be automatically configured by YunoHost!
2019-01-03 18:24:39 +01:00
2020-09-20 10:57:13 +02:00
N.B.: As a fairness measure, each instance may only have **one such domain** setup at any given time.
2019-01-03 18:24:39 +01:00
2020-09-20 10:57:13 +02:00
### Subdomains
2019-01-03 18:24:39 +01:00
2020-09-20 10:57:13 +02:00
The `nohost.me`, `noho.st` and `ynh.fr` domain service does allow the creation of subdomains.
2019-01-03 18:24:39 +01:00
2020-09-20 10:57:13 +02:00
YunoHost allows the installation of applications on subdomains (for example, having the Nextcloud application accessible from the `cloud.mydomain.org` address), this feature is also allowed with the `nohost.me`, `noho.st` and `ynh.fr` domains and so it is possible to have a subdomain such as `my.application.mydomain.nohost.me`. to create a subdomain for `nohost.me`, `noho.st` and `ynh.fr` domain you just have to add the subdomain to yunohost like any other domains.
2019-01-03 18:24:39 +01:00
2019-05-20 11:12:21 +02:00
### Adding a nohost.me, noho.st or ynh.fr domain after the post-installation
2019-01-03 18:24:39 +01:00
2020-09-20 10:57:13 +02:00
If you already did the postinstall and want to add an automatic domain, you may do so from the "Domains" web interface, selecting the option "I don't have a domain name..."
Alternatively, the following commands can be used.
2019-01-03 18:24:39 +01:00
```bash
# Add the domain
yunohost domain add whateveryouwant.nohost.me
# Subscribe/register to the dyndns service
yunohost dyndns subscribe -d whateveryouwant.nohost.me
# [ wait ~ 30 seconds ]
# Update the DNS conf
yunohost dyndns update
# Set it as the main domain
2020-09-23 19:37:21 +02:00
yunohost domain main-domain -n whateveryouwant.nohost.me
2019-01-03 18:24:39 +01:00
```
2019-05-20 11:12:21 +02:00
2020-09-20 10:57:13 +02:00
### Retrieve a nohost.me, noho.st or ynh.fr domain
2019-05-20 11:12:21 +02:00
2020-09-20 10:57:13 +02:00
If you reinstall your server and want to use a domain already used previously, you must request a domain reset on the forum [in the dedicated thread](https://forum.yunohost.org/t/nohost-domain-recovery/442).
2019-05-20 11:12:21 +02:00
2020-09-20 10:57:13 +02:00
### Change a nohost.me, noho.st or ynh.fr domain
2019-05-20 11:12:21 +02:00
2020-09-20 10:57:13 +02:00
If you wish to use a different automatic domain, you first have to remove your present domain registration. This is done in 3 steps:
2019-05-20 11:12:21 +02:00
2020-05-14 16:03:41 +02:00
1. Remove the domain from your instance (via webadmin or the `yunohost domain remove` CLI).
2019-05-20 11:12:21 +02:00
**/!\ Caution: this will remove any app installed on this domain, along with its data.**
2. Ask for registration removal [in the dedicated forum thread](https://forum.yunohost.org/t/nohost-domain-recovery/442).
2020-09-20 10:57:13 +02:00
3. Remove automatic domain configuration files on your server, via CLI only: `sudo rm /etc/cron.d/yunohost-dyndns && sudo rm -r /etc/yunohost/dyndns`
2019-05-20 11:12:21 +02:00
You may then add a new domain.