Subdomains

Eine Subdomain ist ein eigener Sub-Host unter einer bestehenden Domain (z. B. blog.beispiel.de). Sie erhält einen eigenen Vhost-Eintrag und einen eigenen Document Root innerhalb des Webspace der zugeordneten Website — anders als ein Alias, der lediglich ein zusätzlicher Name für dieselbe Site ist.

---

Übersicht

Die Subdomain-Tabelle zeigt alle angelegten Subdomains:

Spalte	Beschreibung
Subdomain	Vollständiger Name (z. B. blog.beispiel.de)
Document Root	Zielverzeichnis innerhalb des Webspace
Status	Aktiv oder inaktiv
Erstellt	Erstellungsdatum

Als Administrator lässt sich die Liste über das Kunden-Filter oben auf einen einzelnen Kunden einschränken.

Kontingent

Die Anzahl möglicher Subdomains richtet sich nach dem Paket des Kunden. Der Zähler am Subdomain erstellen-Button zeigt den Verbrauch (genutzt/limit). Ist das Limit erreicht, ist der Button für Kunden deaktiviert.

---

Subdomain erstellen

1. Navigieren Sie zu Subdomains
2. Klicken Sie auf Subdomain erstellen
3. Füllen Sie das Formular aus:

Feld	Pflicht	Beschreibung
Domain	Ja	Übergeordnete Domain, unter der die Subdomain angelegt wird
Website	Ja	Site, deren Webspace und Konfiguration die Subdomain verwendet
Präfix	Ja	Der Sub-Host-Teil (z. B. blog für blog.beispiel.de)
Document Root	Nein	Zielordner innerhalb des Webspace (Standard: subdomains/<präfix>)

1. Klicken Sie auf Erstellen

Das Präfix darf nur Buchstaben, Ziffern und Bindestriche enthalten und muss mit einem Buchstaben oder einer Ziffer beginnen und enden.

Document Root

Wird kein Zielordner angegeben, legt das System automatisch subdomains/<präfix> innerhalb des Webspace an. Ein eigener Pfad ist relativ zum Home-Verzeichnis der Website — er muss innerhalb des Webspace liegen, ../ ist nicht erlaubt.

Beim Erstellen konfiguriert das System automatisch:

• Anlegen des Document-Root-Verzeichnisses im Webspace der Website (mit korrekten Besitzrechten)
• DNS-A-Record in der Zone der übergeordneten Domain, der auf die Server-IP der Domain zeigt
• Erweiterung des Nginx-Vhosts der Website um den Subdomain-Namen (server_name)
• Neuausstellung des SSL-Zertifikats, sodass die Subdomain in die SAN-Liste aufgenommen wird

PHP-Version

Subdomains laufen über den PHP-FPM-Pool der zugeordneten Website. Standardmäßig wird PHP 8.4 verwendet.

---

Subdomain löschen

1. Klicken Sie in der Aktionsspalte (bzw. auf der mobilen Karte) auf Löschen
2. Bestätigen Sie die Löschung

Beim Löschen werden entfernt:

• Der DNS-A-Record der Subdomain
• Der Subdomain-Name aus dem Nginx-Vhost der Website
• Der Subdomain-Name aus der SAN-Liste des SSL-Zertifikats (Neuausstellung)

Dateien bleiben erhalten

Das Löschen einer Subdomain entfernt die Konfiguration, nicht aber die Dateien im Document-Root-Verzeichnis. Nicht mehr benötigte Dateien entfernen Sie bei Bedarf über den Dateimanager.