Domains¶

Every Asteroid gets its own domain in the form of $USER.uber.space. You can set up as many additional domains as you like.

We don't sell domains

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

List your domains¶

To list your domains use uberspace web domain list:

[isabell@moondust ~]$ uberspace web domain list

  Domain
  ────────────────────
  isabell.example
  isabell.uber.space

Add a domain¶

To use your own domain with your Asteroid for web, you need to set it up using the uberspace tool. You can only add fully qualified domain names (FQDNs).

[isabell@moondust ~]$ uberspace web domain

Usage: uberspace web domain [OPTIONS] COMMAND [ARGS]...

Manage web domains

╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                  │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ add    Add web domain to existing Asteroid on this host.                     │
│ show   Show info and DNS records for a single domain.                        │
│ list   List webdomains on this host.                                         │
│ del    Remove web domain from Asteroid on this host.                         │
╰──────────────────────────────────────────────────────────────────────────────╯

If your domain was isabell.example add it as follows:

[isabell@moondust ~]$ uberspace web domain add isabell.example
OK: Added webdomain 'isabell.example' to your Asteroid

Use the following values for your DNS:

$ORIGIN isabell.example.
@  IN  A     185.139.158.100
@  IN  AAAA  2a0b:20c0:2000:62:be24:11ff:fe7a:d434

The output of this command uses the zone file format to show the proposed records for your domain.

By default, all domains share the same DocumentRoot.

Subdomains¶

Subdomains must be added individually. For example:

[isabell@moondust ~]$ uberspace web domain add www.isabell.example

Tip:

You can also add subdomains for your default $USER.uber.space domain.

Note:

We strongly encourage you to use separate Asteroids for separate projects or apps.

Show details of a domain¶

To output the proposed DNS records of one of your domains, use the uberspace tool:

[isabell@moondust ~]$ uberspace web domain show isabell.example

 Domain: isabell.example

Use the following values for your DNS:

$ORIGIN isabell.example.
@  IN  A     185.139.158.100
@  IN  AAAA  2a0b:20c0:2000:62:be24:11ff:fe7a:d434

Remove a domain¶

To remove a domain use uberspace web domain del:

[isabell@moondust ~]$ uberspace web domain del isabell.example
OK: Removed webdomain 'isabell.example' from your Asteroid