In diesem Artikel wird erklärt, wie Sie eine bei IONOS registrierte Domain für ein auf Vercel gehostetes Projekt verwenden können.

Für die Verbindung stehen Ihnen zwei verschiedene Methoden zur Verfügung: 

Methode A: Konfiguration über DNS-Einträge (Empfohlen)

Sie leiten die Domain per DNS-Record an Vercel weiter. Der Vorteil: Ihre E-Mail-Postfächer und andere IONOS Dienste für diese Domain funktionieren unverändert weiter. 

Methode B: Nutzung der Vercel-Nameserver 

Sie übergeben die vollständige DNS-Verwaltung an Vercel. Achtung: Bestehende Dienste wie IONOS Mail müssen in diesem Fall manuell bei Vercel nachkonfiguriert werden, da sie sonst nicht mehr funktionieren. 

Voraussetzungen

  • Sie haben Ihre Domain bei IONOS registriert.
  • Sie verfügen über ein Vercel-Konto und haben dort bereits ein Projekt bereitgestellt.
  • Sie haben Zugriff auf Ihr IONOS Konto.

Domain in Vercel hinzufügen

Bevor Sie Änderungen bei IONOS vornehmen, müssen Sie die Domain in Vercel hinzufügen. Nur so erhalten Sie die korrekten Zielwerte für Ihre DNS-Einstellungen. 

  • Melden Sie sich bei vercel.com an und öffnen Sie das Projekt, das Sie mit der Domain verbinden möchten.
  • Klicken Sie auf Settings > Domains.
  • Klicken Sie auf Add Domain.
  • Geben Sie Ihre gewünschte Domain ein (zum Beispiel example.com) und bestätigen Sie die Eingabe.
  • Vercel schlägt Ihnen nun automatisch vor, auch die Variante mit „www.“ (z. B. www.example.com) hinzuzufügen. Wir empfehlen Ihnen, diesem Vorschlag zu folgen.
  • Lassen Sie diesen Browsertab geöffnet. Vercel zeigt Ihnen nun die benötigten DNS-Werte an, die Sie bei IONOS eintragen müssen: 
    Für die Hauptdomain (z. B. example.com) wird eine IP-Adresse angezeigt, die als A-Record hinzugefügt werden muss.
    Für die www-Subdomain wird  ein CNAME-Ziel angezeigt(typischerweise cname.vercel-dns.com oder eine projektspezifische Adresse wie z. B. PROJEKTNAME.cname.vercel-dns-NUMMER.com ).

    Wenn Sie die Nameserver-Methode wählen, werden Ihnen zwei Vercel-Nameserver angezeigt. 

Hinweis

Vercel nutzt optimierte, projektspezifische IP-Adressen (Anycast). Kopieren Sie daher bitte immer exakt die IP-Adresse, die Ihnen aktuell in Ihrem persönlichen Vercel-Dashboard angezeigt wird, und nutzen Sie keine IP-Adressen aus anderen Anleitungen. 

Option A: DNS-Einträge bei IONOS konfigurieren (Empfohlen)

Verwenden Sie diese Methode, um Ihre Domain weiterhin über IONOS zu verwalten und bestehende E-Mail-Postfächer und Dienste ohne Unterbrechung weiterzunutzen.

DNS-Einstellungen für Ihre Domain öffnen
  • Loggen Sie sich in Ihr IONOS Konto ein.
  • Klicken Sie in der Titelleiste auf Menü > Domain & SSL.Sie werden zur Übersicht Ihrer Domains weitergeleitet.

  • Klicken Sie neben der entsprechenden Domain unter Aktionen auf das Drei-Punkte-Symbol und wählen Sie DNS aus. Eine Seite mit einer Übersicht über die DNS-Einstellungen der Domain öffnet sich.

A-Record hinzufügen
  • Prüfen Sie zunächst die Liste der bestehenden Einträge. Wenn bereits ein Eintrag vom Typ A existiert (der beispielsweise auf die IONOS Parkseite zeigt), müssen Sie diesen bearbeiten oder löschen. Es darf nur ein einziger A-Record für die Hauptdomain aktiv sein.
  • Klicken Sie auf Record hinzufügen. Die Seite DNS-Record hinzufügen öffnet sich.
  • Klicken Sie auf A. Eine neue Seite öffnet sich.
  • Lassen Sie das Feld Hostname leer. Wenn Sie dieses Feld leer lassen, wird der A-Record für die jeweilige Hauptdomain erstellt.
  • Geben Sie im Feld Zeigt auf die IPv4-Adresse ein, die in Ihrem Vercel-Dashboard angezeigt wird.
  • Belassen Sie im Feld TTL den eingetragenen Standardwert.
  • Klicken Sie auf Speichern. Der A-Record wird hinzugefügt.
www-Subdomain erstellen
  • Gehen Sie im Menü zurück zu Domains & SSL.
  • Klicken Sie neben der Domain unter Aktionen auf das Drei-Punkte-Symbol und wählen Sie die Option Subdomains verwalten aus. Eine neue Seite öffnet sich, auf der eine Übersicht über die erstellten Subdomains angezeigt wird.
  • Wenn die www-Subdomain noch nicht aufgeführt ist, klicken Sie auf Subdomain erstellen. Das Fenster Subdomain erstellen öffnet sich.
  • Geben Sie im Feld Name der Subdomain den gewünschten Namen ein und klicken Sie auf Speichern. Die Subdomain wird erstellt.

CNAME-Eintrag für die www-Subdomain erstellen

Um sicherzustellen, dass Ihre Besucher die Seite auch über Ihre www-Subdomain erreichen, richten Sie nun den CNAME-Record ein. 

  • Gehen Sie im Menü zurück zu Domains & SSL.
  • Klicken Sie neben der Domain unter Aktionen auf das Drei-Punkte-Symbol und wählen Sie DNS. Eine Seite mit einer Übersicht über die DNS-Einstellungen der Domain öffnet sich.
  • Klicken Sie auf Record hinzufügen. Die Seite DNS-Record hinzufügen öffnet sich.
  • Wählen Sie die Option CNAME aus. Eine neue Seite öffnet sich.
  • Geben Sie im Feld Hostname www ein.
  • Geben Sie im Feld Zeigt auf den in Vercel angezeigten CNAME-Wert ein (z. B. cname.vercel-dns.com). Fügen Sie weder http:// noch einen abschließenden Schrägstrich oder Punkt hinzu.
  • Belassen Sie im Feld TTL den eingetragenen Standardwert.
  • Klicken Sie auf Speichern. Der CNAME-Record wird erstellt.
Verbindung in Vercel prüfen

Wechseln Sie zum Browsertab, in dem die Registerkarte Domains in Vercel angezeigt wird. Innerhalb weniger Minuten sollte sich der Status in Gültige Konfiguration ändern. Vercel stellt im Rahmen der Statusänderung automatisch ein SSL-Zertifikat aus. Es kann bis zu 24 Stunden dauern, bis die DNS-Einträge vollständig aktualisiert und alle lokalen Caches geleert sind. Warten Sie daher ab, bevor Sie Fehlerbehebungsmaßnahmen ergreifen.

Option B: Nameserver von Vercel verwenden

Wählen Sie diese Option nur, wenn Sie IONOS nicht zur Verwaltung Ihrer Domain-Einträge (wie z. B. MX für E-Mail) und Dienste für diese Domain benötigen.

Vorsicht

  • Wenn Sie die Nameserver ändern, verliert IONOS die Kontrolle über die DNS-Einträge.
  • Wenn Sie IONOS Mail und andere Dienste von IONOS verwenden, müssen Sie Ihre DNS-Einträge im DNS-Bereich von Vercel vor dem Wechsel neu anlegen. Anderenfalls werden Ihre E-Mail-Postfächer und Dienste nicht mehr funktionieren.
  • Wechseln Sie in den Domain-Einstellungen Ihres Vercel-Projekts zur Methode Nameserver.
  • Kopieren Sie die beiden angezeigten Nameserver (in der Regel ns1.vercel-dns.com und ns2.vercel-dns.com).
  • Wechseln Sie zum Browsertab, in dem Ihr IONOS Konto angezeigt wird.
  • Klicken Sie in der Titelleiste auf Menü > Domains & SSL. Sie werden zur Übersicht Ihrer Domains weitergeleitet.
  • Klicken Sie neben der entsprechenden Domain unter Aktionen auf das Drei-Punkte-Symbol.
  • Klicken Sie auf Nameserver. Eine Seite mit einer Übersicht über die Nameserver öffnet sich.
  • Klicken Sie auf Personalisierte Nameserver verwenden. Die Seite Personalisierte Nameserver verwenden öffnet sich.
  • Geben Sie die Nameserver ein, die Sie von Vercel kopiert haben.
  • Klicken Sie auf Speichern.

Hinweis

Es kann bis zu 48 Stunden dauern, bis Nameserver-Änderungen  wirksam werden.

Erfolgreiche Verknüpfung prüfen
  • Rufen Sie Ihre Domain in Ihrem Browser auf. Sie sollten nun direkt auf Ihr Vercel-Projekt weitergeleitet werden.
  • In Vercel wird neben Ihrer Hauptdomain sowie neben der www-Subdomain ein grünes Häkchen angezeigt.
  • Vercel konfiguriert HTTPS automatisch. Sie müssen bei IONOS kein separates SSL-Zertifikat einrichten. 

Hilfe im Problemfall

Sollte etwas nicht funktionieren, prüfen Sie folgende Lösungsansätze: 

In Vercel wird die Statusmeldung „Ungültige Konfiguration“ angezeigt

Prüfen Sie die DNS-Einträge, die Sie in Ihrem IONOS Konto erstellt haben und vergleichen Sie diese mit den Anforderungen von Vercel. Stellen Sie hierbei sicher, dass die IP-Adresse des A-Records mit der IP-Adresse übereinstimmt, die in Ihrem Vercel-Dashboard angezeigt wird.  Löschen Sie darüber hinaus alle widersprüchlichen A- oder CNAME-Einträge, die für denselben Host vorhanden sind.

Es wird die IONOS Parkseite angezeigt

In diesem Fall ist ein veralteter A-Record aktiv, der auf IONOS verweist. Stellen Sie sicher, dass in den DNS-Einstellungen nur der A-Record angezeigt wird, der auf Vercel verweist.

Die Version mit www. wird nicht aufgelöst

Stellen Sie sicher, dass die www-Subdomain erstellt wurde und dass der CNAME-Record  auf den von Vercel angezeigten CNAME-Wert verweist. Achten Sie darauf, dass im Feld Zeigt auf weder das Präfix http:// (oder https://) noch ein abschließender Punkt eingetragen sind.

Die E-Mail-Postfächer funktionieren nach dem Wechsel der Nameserver nicht mehr

Sie haben zu den Nameservern von Vercel gewechselt, ohne die MX-Einträge neu anzulegen. Sie haben nun zwei Optionen: Entweder Sie wechseln bei IONOS zurück auf die Standard-Nameserver und nutzen stattdessen Methode A, oder Sie hinterlegen die benötigten IONOS MX-Records direkt im DNS-Verwaltungsbereich innerhalb Ihres Vercel-Dashboards. 

Die Änderungen werden nicht angezeigt

Es kann mehrere Stunden dauern, bis die Änderungen aufgrund der dezentralen Struktur des Domain Name Systems weltweit wirksam werden.

Verwenden Sie das Programm dig oder einen Online-DNS-Checker, um zu prüfen, ob die neue DNS-Konfiguration weltweit wirksam ist.