Domains

Every Uberspace account gets its own domain in the form of $USER.uber.space. You can setup as many additional domains as you like.

Tip

Uberspace is strictly a hosting provider, which is why we don’t offer domain registrations. You can, of course, use any domain that you registered with an external domain provider with your Uberspace account. At the end of this article is a list of some popular domain providers.

Setup

In order to use your own domain for web with your Uberspace, you need to first set it up using our uberspace tool. You can only add fully qualified domain names (FQDNs), wildcard domains are not available. By default, all domains set up on a Uberspace account share the same DocumentRoot. Please refer to DocumentRoot for instructions on how to use seperate Document Roots for your domains.

[isabell@philae ~]$ uberspace web domain add isabell.example
The webserver's configuration has been adpated.
Now you can use the following records for your dns:
    A -> 185.26.156.55
    AAAA -> 2a00:d0c0:200:0:b9:1a:9c:37

Once you’ve set up your domain using the uberspace tool, the tool provides you with the A and AAAA records that need to be configured in your registrar’s nameserver.

Tip

Any subdomain that you wish to use needs to be added individually. So in order to also use www.isabell.example, you need to run uberspace web domain add www.isabell.example as well.

Note

The Domain Name System (DNS) is a directory used to look up information about a host name. It usually includes at least a so-called A record, which contains the IPv4 address assigned to this host. The AAAA record does the same for IPv6 addresses. If the domain should be able to receive e-mails, a mail exchange server is specified in the MX record.

There are other types of DNS records used to specify various services for this domain. Wikipedia provides a list if you’re curious.

Note

If you want to add or remove an internationalized domain name (IDN), please use the ASCII representation (“punycode”). For example, please use xn--berspace-55a.de instead of überspace.de.

To convert an internationalized domain name to punycode, use the idn command:

[isabell@stardust ~] $ idn überspace.de
xn--berspace-55a.de

Removal

To remove a domain, use the uberspace tool:

[isabell@philae ~]$ uberspace web domain del isabell.example
The server's configuration has been adapted.

Listing

If you want to find out which domains are currently set up for the web server on your Uberspace account, use the uberspace command:

[isabell@philae ~]$ uberspace web domain list
isabell.example
isabell.uber.space

This will list all domains and sub-domains currently set up for this account, including the default $USER.uber.space.