Domains

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

[isabell@philae ~]$ uberspace mail domain add isabell.example
The mailserver's configuration has been adapted.
Now you can use the following record for your dns:
  MX  -> philae.uberspace.de
  TXT -> v=spf1 mx ~all

Once you’ve set up your domain using the uberspace mail domain add tool, the tool provides you with the MX record that needs to be configured in your registrar’s nameserver.

Warning

Please use only the provided host name for your MX record. If you use any other host name for your MX, the mailserver will not accept your domain. You will also not be able to login to the mailserver using that domain as part of the username before setting up the record.

SPF record

The Sender Policy Framwork (SPF) is a system that allows mailservers to check if another mail server is allowed to send mails for a specific domain. To specify which servers are allowed to send mails for your domain, a TXT DNS record is set. Adding Uberspace host to the list of allowed servers for your domain might increase your chances of passing spam filters. Assuming you have set your Uberspace host as your domain’s MX, you can set a TXT-type record for your domain using this snippet:

v=spf1 mx ~all

This instructs other mail servers to accept mails from your domain if they originate from your domain’s MX and to deliver any mails that claim to be from your domain but originate from a different server to the spam folder.

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 ~] $ echo "überspace.de" | idn
xn--berspace-55a.de

Removal

To remove a domain, use the uberspace tool:

[isabell@philae ~]$ uberspace mail 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 mail server on your Uberspace account, use the uberspace command:

[isabell@philae ~]$ uberspace mail 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.