Skip to content

Domain Aliases

A domain alias is an additional domain name that points to the same website as an existing domain. The alias has no web space of its own and no separate document root — the website is served under the alias name exactly as it is under the primary domain. This distinguishes an alias from a subdomain, which gets its own vhost with its own directory.


Overview

The alias table lists all created domain aliases:

Column Description
Alias The additional domain name (e.g. example.com)
Domain The parent domain whose site the alias points to
Created Creation date

As an administrator, the list can be narrowed to a single customer using the customer filter at the top.

Quota

The number of allowed aliases depends on the customer's package. The counter on the Create Alias button shows usage (used/limit). An alias does not count against the domain quota — it is the same site as its primary domain.


Create Alias

  1. Navigate to Domain Aliases
  2. Click Create Alias
  3. Fill out the form:
Field Required Description
Domain Yes Existing domain whose website should be reachable under the alias
Alias Yes The additional domain name (e.g. example.com)
  1. Click Create

The alias name is validated. When creating, the system automatically configures:

  • A DNS zone for the alias domain with A records for alias and www.alias pointing to the same server IP as the primary domain
  • Adding the alias name to the website's Nginx vhost (server_name) — the site is served identically under both names
  • Re-issuing the SSL certificate so the alias is added to the SAN list and reachable via HTTPS

Own Domain Entry

For each alias, an additional domain entry is created so the alias is visible on the Domains and SSL pages and receives its own certificate SAN. This entry is flagged as an alias and therefore does not count against the domain quota.

DNS Prerequisite

For an SSL certificate to be issued for the alias, the alias domain must point to the server via DNS. Only once the DNS records have converged can the ACME challenge succeed.


Delete Alias

  1. Click Delete in the action column (or on the mobile card)
  2. Confirm the deletion

When deleting, the following are removed:

  • The alias domain's DNS zone
  • The associated domain entry
  • The alias name from the website's Nginx vhost
  • The alias name from the SSL certificate's SAN list (re-issued)

The primary domain and its website remain unaffected.