Quick Menu

Domains

YunoHost lets you manage and serve multiple domains on a single server. So you can host, for example, a blog and Nextcloud on a first domain yolo.com, and a webmail client on a second domain swag.nohost.me. Each domain is automatically configured to handle web services and e-mail.

Domains can be managed in the 'Domains' section of the webadmin, or via the yunohost domain category of the command line.

Whenever you add a domain, it is assumed that you have purchased (or at least control) the domain, so that you can manage its DNS configuration. An exception is domains in .nohost.me, .noho.st and ynh.fr which are offered by the YunoHost Project, and can be directly integrated with YunoHost through automatic DynDNS configuration. To limit abuse and costs, an instance can only have one domain offered at a time, but you can add as many sub-domains to it as you like. For example, if you choose example.ynh.co.uk you can then add the domains video.example.ynh.co.uk or www.exemple.ynh.fr or any other sub-domain you may require.

Domains can be managed in the 'Domain' section of the webadmin, or through the yunohost domain category of the command line.

A screenshot of the webadmin domain interface with an "Add domain" button and a list of domains

3 types of domains

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 yourself, which can be tedious and technical.

The following (sub)domains are offered:

  • whateveryouwant.nohost.me;
  • whateveryouwant.noho.st;
  • whateveryouwant.ynh.fr.

In more, YunoHost uses an integrated dynamic DNS mechanism, so your server can stay reachable even if your public IP change.

To get one of this domain you simply need to choose I don't have a domaine name… during the initial configuration (postinstall) or on the Add domain page.

Here a screenshot of the "Add domain" page where you can choose "I don't have a domain name"

To limit resources costs and abuses, each instance may only have one of these domains setup at any given time, however you can add as many sub-domains of it as you wish. For example, if you choose example.noho.st you can later add the domains video.example.noho.st or www.example.ynh.noho.st or any other sub-domain you may need. In this case you need to select I already have a domain name.

More information on this domains

DNS configuration

DNS (Domain Name System) is a system that enables computers worldwide to translate human-readable domain names (such as yolo.com) into machine-readable IP addresses (such as 11.22.33.44). For this translation (and other features) to work, DNS records need to be carefully configured.

YunoHost can generate a recommended DNS configuration for each domain, including the records required for e-mail. The recommended DNS configuration is available in the web administrator via Domains > (the domain) > DNS configuration, or with the command yunohost domain dns suggest the.domain.tld.

About Non-latin characters

If your domain has special, non-latin characters, it will be transformed by YunoHost into its internationalized version through Punycode. So when you use the command line, you have to use the punycode format return for example by yunohost domain list.

SSL/HTTPS certificates

Another important aspect of domain configuration is the SSL/HTTPS certificate. YunoHost is integrated with Let's Encrypt, so once your server is correctly reachable from anybody on the internet through the domain name, the administrator can request a Let's Encrypt certificate. See the documentation about certificates for more information.

Found errors? Think you can improve this documentation? Simply click the Edit link at the top of the page, and then the icon on Github to suggest changes.