Skip to content

Latest commit



77 lines (48 loc) · 3.28 KB


File metadata and controls

77 lines (48 loc) · 3.28 KB


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


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, because let's encrypt does not support wildcard domains in conjunction with HTTP validation.

[isabell@stardust ~]$ uberspace web domain add isabell.example
The webserver's configuration has been adapted.
Now you can use the following records for your DNS:
    A ->
    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.

To start publishing content on your new domain, upload it to /var/www/virtual/isabell/html or /home/isabell/html. By default, all domains share the same docroot <web-documentroot>. Please refer to docroot <web-documentroot> for instructions on how to use serve different content under a given domain.


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. You can also add subdomains for your domain.

Because we check on each host if a domain is already under control of another user of that host, you might encounter an error if you try to add a subdomain with another user than the one you used to configure the same main domain:

[isabell@stardust ~]$ uberspace web domain add
[isabell2@stardust ~]$ uberspace web domain add
Can't add domain to the configuration. It is a subdomain of a domain already configured for another Uberspace account.

Then you can just add the subdomain first on the one user and then the main domain on the other user.


We very much encourage you to use separate Uberspace accounts for separate projects or apps and so for subdomains. And you shouldn't usually run into this problem because in most cases you won't end up with different users on the same host.

Note that you will also encounter this error if the main domain is configured as a mail domain (and not as web domain) on another Uberspace account.


To remove a domain, use the uberspace tool:

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


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@stardust ~]$ uberspace web domain list

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