Subdomains¶
A subdomain is its own sub-host under an existing domain (e.g. blog.example.com). It gets its own vhost entry and its own document root inside the web space of the assigned website — unlike an alias, which is merely an additional name for the same site.
Overview¶
The subdomain table lists all created subdomains:
| Column | Description |
|---|---|
| Subdomain | Full name (e.g. blog.example.com) |
| Document Root | Target directory within the web space |
| Status | Active or inactive |
| 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 subdomains depends on the customer's package. The counter on the Create Subdomain button shows usage (used/limit). Once the limit is reached, the button is disabled for customers.
Create Subdomain¶
- Navigate to Subdomains
- Click Create Subdomain
- Fill out the form:
| Field | Required | Description |
|---|---|---|
| Domain | Yes | Parent domain under which the subdomain is created |
| Website | Yes | Site whose web space and configuration the subdomain uses |
| Prefix | Yes | The sub-host part (e.g. blog for blog.example.com) |
| Document Root | No | Target folder within the web space (default: subdomains/<prefix>) |
- Click Create
The prefix may only contain letters, digits, and hyphens, and must start and end with a letter or digit.
Document Root
If no target folder is specified, the system automatically creates subdomains/<prefix> within the web space. A custom path is relative to the website's home directory — it must stay within the web space, ../ is not allowed.
When creating, the system automatically configures:
- Creation of the document root directory in the website's web space (with correct ownership)
- A DNS A record in the parent domain's zone pointing to the domain's server IP
- Adding the subdomain name to the website's Nginx vhost (
server_name) - Re-issuing the SSL certificate so the subdomain is added to the SAN list
PHP Version
Subdomains run through the assigned website's PHP-FPM pool. PHP 8.4 is used by default.
Delete Subdomain¶
- Click Delete in the action column (or on the mobile card)
- Confirm the deletion
When deleting, the following are removed:
- The subdomain's DNS A record
- The subdomain name from the website's Nginx vhost
- The subdomain name from the SSL certificate's SAN list (re-issued)
Files Are Kept
Deleting a subdomain removes the configuration but not the files in the document root directory. Remove files that are no longer needed via the file manager if required.