GitHub Pages Custom Domain: DNS, CNAME und HTTPS einrichten

So richten Sie eine eigene Domain für GitHub Pages ein: DNS-Einträge für Apex und www, Aufgabe der CNAME-Datei, Domain-Verifizierung und HTTPS aktivieren.

Häufige Fragen

Welche IP-Adressen verwende ich für eine GitHub-Pages-Apex-Domain?

Die Dokumentation von GitHub (Stand: November 2026) nennt vier A-Records für den Apex-Host (@): 185.199.108.153, 185.199.109.153, 185.199.110.153 und 185.199.111.153. Wenn Sie zusätzlich IPv6 nutzen möchten, legen Sie vier AAAA-Records an: 2606:50c0:8000::153, 2606:50c0:8001::153, 2606:50c0:8002::153 und 2606:50c0:8003::153. GitHub empfiehlt, die A-Records neben den AAAA-Records beizubehalten. Gleichen Sie die Werte mit der Dokumentation ab, bevor Sie sie einfügen, denn GitHub kann sie ändern.

Brauche ich eine CNAME-Datei in meinem Repository?

Nur, wenn Sie aus einem Branch veröffentlichen. In diesem Fall committet GitHub beim Speichern der Custom Domain unter Settings > Pages automatisch eine CNAME-Datei ins Stammverzeichnis des Quell-Branches. Veröffentlichen Sie über einen eigenen GitHub-Actions-Workflow, wird laut GitHub keine CNAME-Datei erstellt; eine vorhandene wird ignoriert und ist nicht erforderlich.

Warum ist das Kontrollkästchen „Enforce HTTPS“ ausgegraut?

Laut GitHub kann es bis zu 24 Stunden dauern, bis die Option nach dem Hinzufügen der Domain verfügbar ist. Das Zertifikat wird automatisch ausgestellt. Die üblichen Ursachen für ein hängendes Kontrollkästchen sind daher noch nicht propagiertes DNS oder zusätzliche Einträge, etwa weitere A-, AAAA-, ALIAS- oder ANAME-Records auf dem Apex oder ein CNAME auf www, der nicht auf GitHub zeigt. Außerdem muss die Domain laut GitHub kürzer als 64 Zeichen sein. Wenn es hakt, klicken Sie neben der Domain auf Remove, geben Sie sie erneut ein und speichern Sie noch einmal.

Sollte ich die Apex-Domain oder www verwenden?

GitHub empfiehlt www. Laut Dokumentation sind www-Subdomains der stabilste Typ einer Custom Domain, weil Änderungen an den Server-IP-Adressen von GitHub sie nicht betreffen. Welche Variante Sie auch als Custom Domain festlegen: GitHub leitet die jeweils andere darauf weiter, solange das DNS beider auf GitHub Pages zeigt.

Wie lange dauert es, bis eine GitHub-Pages-Custom-Domain funktioniert?

Laut GitHub kann die Verbreitung von DNS-Änderungen bis zu 24 Stunden dauern. In der Praxis lösen viele Einträge schneller auf, planen Sie aber einen Tag ein, bevor Sie von einem Fehler ausgehen.

Ist ein Wildcard-DNS-Eintrag für GitHub Pages sicher?

GitHub rät ausdrücklich von Wildcard-Einträgen wie *.example.com ab. Laut Dokumentation besteht damit sofort das Risiko einer Domain-Übernahme, selbst wenn Sie die Domain verifizieren. Legen Sie stattdessen Einträge für die konkreten Subdomains an, die Sie verwenden.

Kurzantwort: Öffnen Sie in Ihrem Repository Settings > Pages, tragen Sie Ihre Domain unter Custom domain ein und speichern Sie. Lassen Sie dann bei Ihrem DNS-Anbieter www per CNAME-Eintrag auf <username>.github.io zeigen und die nackte Domain (example.com) per vier A-Records auf GitHub. Sobald GitHub das Zertifikat ausgestellt hat, setzen Sie den Haken bei Enforce HTTPS. Das Ganze besteht aus einer Repo-Einstellung und ein paar DNS-Einträgen. Die meisten Verzögerungen entstehen durch die DNS-Propagierung, die laut GitHub bis zu 24 Stunden dauern kann.

Alles Folgende wurde im November 2026 anhand der offiziellen GitHub-Dokumentation geprüft. Gerade die DNS-Werte ändern sich am ehesten. Bestätigen Sie sie deshalb in der GitHub-Pages-Dokumentation zur Custom Domain, bevor Sie sie einfügen.

Zuerst den Domain-Typ wählen

Besucher sollen landen auf	Als Custom Domain festlegen	Benötigte DNS-Einträge	Hinweise
`www.example.com`	`www.example.com`	CNAME auf `www` zu `<username>.github.io`, plus A-Records auf dem Apex	Von GitHub empfohlene Variante. `example.com` leitet auf www weiter.
`example.com`	`example.com`	A-Records auf dem Apex (oder ein ALIAS/ANAME), plus CNAME auf `www`	`www.example.com` leitet auf den Apex weiter.
`blog.example.com`	`blog.example.com`	CNAME auf `blog` zu `<username>.github.io`	Keine Apex-Einträge nötig.

Laut GitHub-Dokumentation sind www-Subdomains die stabilste Wahl, weil Änderungen an den Server-IP-Adressen von GitHub sie nicht betreffen. Wenn nichts Konkretes für die nackte Domain spricht, nehmen Sie www. Falls Sie noch einen Registrar suchen, hilft unser Vergleich der Domain-Registrare weiter, und was eine Domain kostet erklärt die Verlängerungspreise.

Schritt für Schritt: Domain verbinden

Domain in GitHub hinzufügen. Öffnen Sie Ihr Repository, klicken Sie auf Settings und dann auf Pages (unter „Code, planning, and automation“). Ist der Reiter Settings ausgeblendet, finden Sie ihn im Dropdown „More“. Tragen Sie Ihre Domain in das Feld Custom domain ein und klicken Sie auf Save.
Prüfen, was GitHub in Ihrem Repo getan hat. Wenn Sie aus einem Branch veröffentlichen, committet GitHub eine CNAME-Datei ins Stammverzeichnis dieses Branches. Veröffentlichen Sie über einen eigenen GitHub-Actions-Workflow, wird keine CNAME-Datei erstellt, und eine vorhandene wird ignoriert.
Standard-DNS-Einträge entfernen. Hat Ihr DNS-Anbieter für den Host, den Sie gleich verwenden, automatisch einen Parking- oder Standardeintrag angelegt, löschen Sie ihn zuerst.
DNS-Einträge anlegen bei Ihrem DNS-Anbieter (siehe nächster Abschnitt).
Auf die Propagierung warten. GitHub nennt bis zu 24 Stunden. Den Fortschritt prüfen Sie im Terminal mit dig www.example.com +noall +answer.
HTTPS erzwingen, sobald die Option verfügbar ist (siehe unten).

Die Reihenfolge ist weniger wichtig, als man denkt

Sie können die DNS-Einträge vor oder nach dem Speichern der Domain in GitHub anlegen. Riskant ist nur, wenn das DNS auf GitHub Pages zeigt, die Domain aber von keinem Repo beansprucht wird. GitHub warnt: Wer das DNS konfiguriert, ohne die Domain in GitHub hinzuzufügen, riskiert, dass jemand anderes eine Website auf einer Ihrer Subdomains hostet. Speichern Sie die Domain deshalb zuerst in GitHub und kümmern Sie sich danach um das DNS.

Die DNS-Einträge

www oder jede Subdomain: ein CNAME

Typ	Host	Wert
CNAME	`www`	`<username>.github.io`

Verwenden Sie Ihren Benutzer- oder Organisationsnamen, ohne den Repository-Namen. GitHub sagt ausdrücklich, dass der CNAME nicht auf die eindeutige *.pages.github.io-Adresse aus Ihren Repository-Einstellungen zeigen soll.

Apex-Domain: vier A-Records (geprüft im November 2026)

Typ	Host	Wert
A	`@`	`185.199.108.153`
A	`@`	`185.199.109.153`
A	`@`	`185.199.110.153`
A	`@`	`185.199.111.153`

Optional IPv6, falls gewünscht, als AAAA-Records auf @:

Typ	Host	Wert
AAAA	`@`	`2606:50c0:8000::153`
AAAA	`@`	`2606:50c0:8001::153`
AAAA	`@`	`2606:50c0:8002::153`
AAAA	`@`	`2606:50c0:8003::153`

GitHub empfiehlt, die A-Records auch dann anzulegen, wenn Sie AAAA-Records hinzufügen, weil IPv6 noch nicht überall verbreitet ist. Unterstützt Ihr DNS-Anbieter ALIAS- oder ANAME-Records, können Sie statt der A- und AAAA-Records einen einzigen Eintrag verwenden, der auf <username>.github.io zeigt.

Zwei Fehler, die Sie vermeiden sollten:

Zusätzliche Einträge auf dem Apex. Laut GitHub können weitere A-, AAAA-, ALIAS- oder ANAME-Records auf @ oder ein CNAME auf www, der woandershin zeigt, die Ausstellung des HTTPS-Zertifikats verhindern.
Eine Subdomain auf den Apex zeigen lassen. GitHub warnt, dass dies Probleme beim Erzwingen von HTTPS verursacht und die Subdomain Ihre Website unter Umständen gar nicht mehr erreicht. Lassen Sie Subdomains auf <username>.github.io zeigen.

Manche Anbieter verwenden @ für den Apex-Host, andere verlangen ein leeres Feld oder die vollständige Domain. Das ist eine Eigenheit des Anbieters, keine GitHub-Einstellung.

HTTPS aktivieren

GitHub stellt Zertifikate für Custom Domains über Let's Encrypt aus. Sobald das DNS korrekt auflöst:

Gehen Sie zurück zu Settings > Pages.
Suchen Sie nach einem Häkchen neben Ihrer Domain. Es bedeutet, dass die DNS-Prüfung bestanden wurde.
Setzen Sie den Haken bei Enforce HTTPS.

Laut GitHub kann es bis zu 24 Stunden dauern, bis die Option verfügbar wird. Erscheint sie auch einige Minuten nach dem Speichern nicht, empfiehlt GitHub: Klicken Sie neben der Custom Domain auf Remove, geben Sie sie erneut ein und klicken Sie wieder auf Save. Die Domain muss außerdem kürzer als 64 Zeichen sein, damit ein Zertifikat erstellt werden kann.

Bleibt das Kontrollkästchen ausgegraut, gehen Sie diese Liste durch:

[ ] Das DNS des Hosts löst auf GitHub auf (dig zeigt die vier IPs oder Ihren <username>.github.io-CNAME)
[ ] Keine zusätzlichen A-, AAAA-, ALIAS- oder ANAME-Records auf dem Apex
[ ] Der www-CNAME zeigt auf <username>.github.io, nicht auf den Apex oder eine pages.github.io-Adresse
[ ] Die Domain unter Settings > Pages stimmt exakt mit dem überein, was Sie im DNS eingetragen haben
[ ] Sie haben die Domain einmal entfernt und neu hinzugefügt

Domain verifizieren (dringend empfohlen)

Die Verifizierung verhindert, dass andere GitHub-Konten Ihre Domain übernehmen, falls Ihre Pages-Website jemals getrennt wird. GitHub nennt Domain-Übernahmen möglich, wenn Sie das Repository löschen, Ihr Abrechnungsplan herabgestuft wird oder eine andere Änderung die Domain trennt, während sie weiterhin für GitHub Pages konfiguriert und nicht verifiziert ist.

Öffnen Sie Ihre Profil-Einstellungen (nicht die Repo-Einstellungen) und dann Pages in der Seitenleiste.
Klicken Sie auf Add a domain, geben Sie die Domain ein und bestätigen Sie.
Legen Sie den TXT-Record an, den GitHub Ihnen anzeigt. Der Host sieht so aus: _github-pages-challenge-USERNAME.example.com.
Prüfen Sie mit dig _github-pages-challenge-USERNAME.example.com +nostats +nocomments +nocmd TXT, dass er sichtbar ist.
Wählen Sie zurück in GitHub im Menü neben der Domain Continue verifying und dann Verify.

Laut GitHub geht das sofort oder dauert bis zu 24 Stunden. Lassen Sie den TXT-Record danach bestehen. Verzichten Sie außerdem auf Wildcard-Einträge wie *.example.com: GitHub zufolge bergen sie ein Übernahmerisiko, selbst wenn die Domain verifiziert ist.

Häufige Probleme

404 auf der eigenen Domain, Website läuft unter github.io. Die Domain wurde nie unter Settings > Pages gespeichert, oder das DNS ist noch nicht propagiert. Prüfen Sie beides.
Domain wird nach einem Deployment zurückgesetzt. Wenn Sie aus einem Branch veröffentlichen, muss die CNAME-Datei im Quell-Branch Ihre Domain enthalten. Ein Build, der das Stammverzeichnis des Branches leert, oder ein Deployment ohne diese Datei kann sie entfernen. Mit einem eigenen Actions-Workflow wird die Datei überflüssig.
Apex funktioniert, www nicht (oder umgekehrt). Beide Hosts brauchen Einträge. Denken Sie daran: GitHub leitet den jeweils anderen Host nur weiter, wenn auch dessen DNS auf GitHub Pages zeigt.
Das Zertifikat kommt nie an. Gehen Sie die Checkliste oben durch und suchen Sie zuerst nach überzähligen Einträgen.

Wenn Sie das DNS lieber nicht selbst verwalten möchten

GitHub Pages passt gut für statische Websites, die Sie ohnehin in einem Repository pflegen. Wenn Sie vor allem eine Website mit eigener Domain online bringen möchten, führen Sie die Custom Domains von We.Inc durch denselben DNS-Schritt direkt im Builder, und die Anleitung zur Domain-Verbindung deckt ihn für jeden Anbieter ab. Im kostenlosen Tarif von We.Inc können Sie bis zu drei Websites aus fertigen Vorlagen veröffentlichen. Der KI-Builder, der aus einem Prompt eine Website entwirft, startet im Starter-Tarif für $20 im Monat. Sie können sich hier registrieren.

Kostenlos starten · Keine Kreditkarte nötig

Umair Ali Sadaqat

Gründer von We.Inc

Umair ist der Gründer von We.Inc. Er schreibt über die Erstellung von Websites mit KI, Agenturen und den Geschäftsbetrieb eines Webstudios.

Bereit, etwas Großartiges zu bauen?

Schließe dich 15,000+ Unternehmen an, die mit We.Inc starten, wachsen und automatisieren, alles auf einer Plattform.