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¶
- Navigate to Domain Aliases
- Click Create Alias
- 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) |
- Click Create
The alias name is validated. When creating, the system automatically configures:
- A DNS zone for the alias domain with A records for
aliasandwww.aliaspointing 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¶
- Click Delete in the action column (or on the mobile card)
- 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.