Tools für eigene Domains
Du verbindest und verwaltest Domains über die Hosting-Tools.
Auf dieser Seite
Verbinde eine Domain, prüfe ihr DNS und wähle die Hauptdomain. Die DNS-Einträge setzt du selbst bei deinem Anbieter.
Hinweis
Die Verbindung gilt für den Space. Du bist dort Mitglied, und der Space ist nicht gesperrt. Ein Space ist ein gemeinsamer Arbeitsbereich in der App.
Für alle vier Tools brauchst du die Rolle Inhaber, Administrator oder Anwender. Die Rolle Lesend genügt nicht.
hosting_add_domain Add domain
ändert Daten
Fügt einem Projekt eine eigene Domain hinzu. Die Domain wartet danach: Die Website liefert sie erst aus, wenn das DNS gesetzt ist, hosting_check_domain es für richtig befunden hat und das Zertifikat da ist.
Die Antwort nennt die nötigen DNS-Einträge. Fehlen sie wegen ausstehender Übertragung, rufe hosting_check_domain auf.
- Der Hostname hat höchstens 253 Zeichen, ist keine IP-Adresse und steht ohne
https://und ohne Pfad da. Hostnamen in den Zonenteisenda.com,teisendapages.comundteisendahosting.comlehnt TEISENDA ab. - Ein Projekt hat höchstens 19 eigene Domains.
- Der Tarif begrenzt die eigenen Domains je Space: Ein Space darf so viele haben, wie sein Tarif Projekte erlaubt, also 1 im Tarif Free und 10 im Tarif Max. Zu einem gebuchten Tarif Max gibt es Pakete mit je 5 weiteren Projekten und damit 5 weiteren eigenen Domains; siehe Pakete nachkaufen und abbestellen. Ist die Zahl erreicht, lehnt TEISENDA den Aufruf ab und ändert nichts.
Welche DNS-Einträge nennt die Antwort, und wofür sind sie?
Einen AAAA-Eintrag führt die Liste nur, wo der Hosting-Knoten einen nennt. Der TXT-Eintrag mit dem Namen _teisenda-hosting.<Domain> und dem Wert teisenda-hosting=<Nachweis> belegt, dass die Domain dir gehört.
| Parameter | Typ | Angabe | Beschreibung |
|---|---|---|---|
space | Ganze Zahl | erforderlich | Die zehnstellige Space-ID. |
project | Ganze Zahl | erforderlich | Die Nummer des Projekts, wie hosting_list_projects sie zeigt. |
hostname | Text | erforderlich | Ein Hostname ohne https:// und ohne Pfad, zum Beispiel www.example.com. |
hosting_check_domain Check domain
ändert Daten
Prüft das DNS und schaltet die Domain bei passenden Einträgen frei. Das Zertifikat wird danach im Hintergrund ausgestellt.
Rufe das Tool erneut auf, um den aktuellen Stand zu prüfen. Nach gescheitertem Zertifikat startet es einen weiteren Versuch.
Bei unpassendem DNS nennt die Antwort die Probleme und Setze entweder den CNAME-Eintrag oder den A-Eintrag, dazu den TXT-Eintrag als Besitznachweis..
| Parameter | Typ | Angabe | Beschreibung |
|---|---|---|---|
space | Ganze Zahl | erforderlich | Die zehnstellige Space-ID. |
project | Ganze Zahl | erforderlich | Die Nummer des Projekts, wie hosting_list_projects sie zeigt. |
hostname | Text | erforderlich | Ein Hostname ohne https:// und ohne Pfad, zum Beispiel www.example.com. |
hosting_set_primary_domain Set primary domain
ändert Datenlöscht, überschreibt oder ändert Sichtbares
Legt die Hauptdomain fest: die Adresse, auf die alle anderen Adressen des Projekts weiterleiten. Das ist eine aktive eigene Domain oder, wenn hostname fehlt, die TEISENDA-Adresse des Projekts.
Die Hauptdomain wechselt beim ersten Aufruf. Eine eigene Domain muss aktiv sein; Besucher sehen die Änderung, sobald sie übertragen ist.
| Parameter | Typ | Angabe | Beschreibung |
|---|---|---|---|
space | Ganze Zahl | erforderlich | Die zehnstellige Space-ID. |
project | Ganze Zahl | erforderlich | Die Nummer des Projekts, wie hosting_list_projects sie zeigt. |
hostname | Text | optional | Die eigene Domain, die zur Hauptdomain wird: ein Hostname ohne https:// und ohne Pfad, zum Beispiel www.example.com. Fehlt er, wird die TEISENDA-Adresse zur Hauptdomain. |
hosting_remove_domain Remove domain
ändert Datenlöscht, überschreibt oder ändert Sichtbareszwei Schritte
Entfernt Domain und Zertifikat. War sie Hauptdomain, gilt wieder die TEISENDA-Adresse.
Rufe das Tool zuerst ohne confirm auf. Erst der zweite Aufruf mit dem ausgegebenen Bestätigungssatz entfernt die Domain; die Anwendung soll vorher deine Zustimmung einholen.
| Parameter | Typ | Angabe | Beschreibung |
|---|---|---|---|
space | Ganze Zahl | erforderlich | Die zehnstellige Space-ID. |
project | Ganze Zahl | erforderlich | Die Nummer des Projekts, wie hosting_list_projects sie zeigt. |
hostname | Text | erforderlich | Ein Hostname ohne https:// und ohne Pfad, zum Beispiel www.example.com. |
confirm | Text | optional | Beim ersten Aufruf soll die Anwendung ihn weglassen; die Antwort nennt dann einen Bestätigungssatz. Genau diesen Satz soll sie erst senden, nachdem du zugestimmt hast. |
Wenn etwas nicht klappt
Wo eine Abhilfe ein Tool nennt, bittest du die Anwendung, es aufzurufen. Die Meldung zum Tarif endet mit dem Satz „Der Tarif dieses Space steht in TEISENDA unter Einstellungen › Tarife.“; in den Einstellungen heißt der Eintrag Abrechnung.
Das ist kein gültiger Hostname. Gib ihn ohne https:// und ohne Pfad ein.
Der Hostname ist nicht gültig. Er hat höchstens 253 Zeichen, ist keine IP-Adresse und kommt ohne https:// und ohne Pfad. Nenne den bloßen Hostnamen, zum Beispiel www.example.com.
Diese Domain ist gesperrt.
Der Hostname liegt in einer Zone, die kein Projekt benutzen darf: teisenda.com oder teisendapages.com. Nimm eine eigene Domain.
Adressen in dieser Zone vergibt TEISENDA selbst.
Der Hostname liegt in der Zone teisendahosting.com, in der TEISENDA selbst die TEISENDA-Adressen vergibt. Nimm eine eigene Domain.
Diese Domain führt schon zu einem Projekt.
Die Domain führt schon zu einem Projekt: zu diesem, zu einem anderen Projekt des Space oder zu einem Projekt eines anderen Space. Dieselbe Meldung kommt, wenn der Hosting-Knoten die Domain an einem Projekt kennt. Ein Hostname kann nur zu einem Projekt gehören, über alle Spaces hinweg. Entferne sie zuerst von dem anderen Projekt, mit hosting_remove_domain, oder nimm einen anderen Hostnamen.
„Mehr als … eigene Domains sind nicht möglich.“
Das Projekt hat schon 19 eigene Domains. Entferne zuerst eine Domain.
„Der Tarif dieses Space erlaubt keine weiteren eigenen Domains: … von … sind hinzugefügt. Es wurde nichts geändert. …“
Der Tarif des Space erlaubt keine weitere eigene Domain: Ein Space darf so viele haben, wie sein Tarif Projekte erlaubt. TEISENDA hat nichts geändert. Entferne eine Domain. Mehr Projekte und damit mehr eigene Domains erlauben der Tarif Max und seine Pakete; siehe Tarife Free und Max und Pakete nachkaufen und abbestellen.
„Die Domain … gehört nicht zu diesem Projekt.“
Die Domain gehört nicht zu diesem Projekt. Sieh die Domains des Projekts mit hosting_project_status nach.
Erst möglich, wenn die Domain aktiv ist.
hosting_set_primary_domain kam für eine Domain, die noch nicht aktiv ist. Schließe die Einrichtung des DNS ab, und rufe hosting_check_domain auf, bis die Domain aktiv ist.
„Das DNS von … stimmt noch nicht:“
Keine Ablehnung: hosting_check_domain hat festgestellt, dass das DNS der Domain noch nicht stimmt. Dem Satz folgt je Problem eine Zeile; die Zeilen stehen im nächsten Abschnitt. Setze die DNS-Einträge bei deinem DNS-Anbieter, und rufe hosting_check_domain erneut auf.
Diese Probleme meldet hosting_check_domain
Keine dieser Zeilen ist eine Ablehnung. Die ersten neun stehen im Ergebnis von hosting_check_domain, solange das DNS nicht stimmt. Die letzten drei sind das Problem, das an der Domain gespeichert ist; hosting_project_status und hosting_check_domain zeigen es als Problem der Domain.
Für die Domain gibt es keinen DNS-Eintrag.
Der Name der Domain führt nirgendwohin: Am Ende seiner CNAME-Kette findet der Hosting-Knoten weder einen A-Eintrag noch einen AAAA-Eintrag. Setze den CNAME-Eintrag oder den A-Eintrag, den das Ergebnis nennt.
Der A-Eintrag fehlt.
Die Domain hat einen AAAA-Eintrag, aber keinen A-Eintrag. Setze den A-Eintrag mit dem Wert, den das Ergebnis nennt, oder stattdessen den CNAME-Eintrag.
Es gibt einen weiteren A-Eintrag, der woandershin zeigt.
Neben dem A-Eintrag, der auf den Hosting-Knoten zeigt, hat die Domain einen weiteren A-Eintrag, der woandershin zeigt. Entferne den anderen A-Eintrag bei deinem DNS-Anbieter.
Die Domain zeigt auf einen anderen Server.
Die Domain hat A-Einträge, und keiner davon ist die Adresse des Hosting-Knotens: Sie zeigt auf einen anderen Server. Ersetze den vorhandenen CNAME-Eintrag oder A-Eintrag durch den, den das Ergebnis nennt.
Es gibt einen AAAA-Eintrag, der woandershin zeigt.
Die Domain hat einen AAAA-Eintrag, der nicht die IPv6-Adresse des Hosting-Knotens ist. Die Zertifizierungsstelle bevorzugt IPv6 und scheitert an einem solchen Eintrag. Entferne diesen AAAA-Eintrag, oder setze ihn auf den Wert, den das Ergebnis nennt, wo es einen nennt.
Ein CAA-Eintrag verbietet das Ausstellen des Zertifikats.
Ein CAA-Eintrag der Domain oder eines Namens darüber erlaubt Zertifikate nur von anderen Zertifizierungsstellen als Let's Encrypt, die der Hosting-Knoten benutzt. Ändere oder entferne den CAA-Eintrag bei deinem DNS-Anbieter, sodass er letsencrypt.org erlaubt.
Der Besitznachweis fehlt: Der TXT-Eintrag ist nicht gesetzt.
Der Besitznachweis fehlt: Die Domain zeigt weder per CNAME auf eine Adresse desselben Projekts unter teisendahosting.com, noch trägt der TXT-Eintrag _teisenda-hosting.<Domain> den erwarteten Wert. Ein A-Eintrag allein belegt nichts. Setze den TXT-Eintrag mit dem Namen und dem Wert, die das Ergebnis nennt.
Das DNS der Domain antwortet nicht.
Die Resolver, die der Hosting-Knoten fragt, haben für die Domain nicht geantwortet. Das DNS ließ sich deshalb nicht prüfen. Prüfe bei deinem DNS-Anbieter, dass die Domain auflöst, und rufe hosting_check_domain erneut auf.
Die Einträge sind noch nicht überall angekommen. Versuch es in einigen Minuten noch einmal.
Einer der beiden öffentlichen Resolver, die der Hosting-Knoten fragt, sieht die Einträge schon richtig, der andere noch nicht. Diese Zeile steht dann allein. Warte einige Minuten, und rufe hosting_check_domain erneut auf.
Das DNS stimmt noch nicht.
Ein Versuch, die Domain freizuschalten, fand das DNS in diesem Moment nicht richtig. Ein Zertifikat ist deshalb nicht angefordert. Korrigiere das DNS, und rufe hosting_check_domain erneut auf.
Das Zertifikat wurde abgelehnt.
Das Ausstellen des Zertifikats ist gescheitert, gleich aus welchem Grund. Die Domain hat dann den Zustand failed. Prüfe die DNS-Einträge, besonders einen CAA-Eintrag, und rufe hosting_check_domain erneut auf; das startet einen neuen Versuch, sobald das DNS stimmt. Bleibt es dabei, wende dich an den Support.
Der Hosting-Knoten meldet ein Problem mit dieser Domain.
Der Hosting-Knoten meldet etwas, wofür TEISENDA keinen eigenen Satz hat, zum Beispiel dass ein Neustart des Knotens das Ausstellen des Zertifikats unterbrochen hat. Rufe hosting_check_domain erneut auf.
Meldungen zu Space und Projektnummer stehen bei den Tools für Spaces und Projekte. Alle anderen, die bei jedem Tool vorkommen können, stehen unter Fehler beim Connector beheben.