GitHub Pages eigen domein: DNS, CNAME en HTTPS instellen

Een eigen domein koppelen aan GitHub Pages: DNS-records voor apex en www, wat het CNAME-bestand doet, domeinverificatie en HTTPS inschakelen.

Veelgestelde vragen

Welke IP-adressen gebruik ik voor een GitHub Pages apex-domein?

In de documentatie van GitHub (gecontroleerd in november 2026) staan vier A-records voor de apex-host (@): 185.199.108.153, 185.199.109.153, 185.199.110.153 en 185.199.111.153. Wil je ook IPv6, voeg dan vier AAAA-records toe: 2606:50c0:8000::153, 2606:50c0:8001::153, 2606:50c0:8002::153 en 2606:50c0:8003::153. GitHub raadt aan de A-records te behouden naast de AAAA-records. Vergelijk de waarden met de documentatie voordat je ze plakt, want GitHub kan ze wijzigen.

Heb ik een CNAME-bestand nodig in mijn repository?

Alleen als je publiceert vanaf een branch. Dan commit GitHub zelf een CNAME-bestand in de root van de bronbranch zodra je het eigen domein opslaat in Settings > Pages (Instellingen > Pages). Publiceer je met een eigen GitHub Actions-workflow, dan wordt er volgens GitHub geen CNAME-bestand aangemaakt en wordt een bestaand bestand genegeerd en is het niet nodig.

Waarom is het selectievakje Enforce HTTPS grijs?

Volgens GitHub kan het tot 24 uur duren voordat de optie beschikbaar is nadat je het domein hebt toegevoegd. Het certificaat wordt automatisch uitgegeven, dus de gebruikelijke oorzaken van een vastzittend vakje zijn DNS die nog niet is doorgevoerd of extra records, zoals extra A-, AAAA-, ALIAS- of ANAME-records op de apex, of een CNAME op www die naar iets anders wijst dan GitHub. GitHub merkt ook op dat het domein uit minder dan 64 tekens moet bestaan. Loopt het vast, klik dan op Remove (Verwijderen) naast het domein, typ het opnieuw in en sla het nogmaals op.

Kan ik beter het apex-domein of www gebruiken?

GitHub raadt www aan. Volgens de documentatie zijn www-subdomeinen het stabielste type eigen domein, omdat ze niet worden beïnvloed door wijzigingen in de IP-adressen van de servers van GitHub. Welke je ook instelt als eigen domein, GitHub verwijst de andere ernaar door, zolang de DNS van beide naar GitHub Pages wijst.

Hoe lang duurt het voordat een eigen domein bij GitHub Pages werkt?

Volgens GitHub kan het doorvoeren van DNS-wijzigingen tot 24 uur duren. In de praktijk werken veel records sneller, maar reken op een dag voordat je denkt dat er iets stuk is.

Is een wildcard-DNS-record veilig voor GitHub Pages?

GitHub raadt wildcard-records zoals *.example.com sterk af. Volgens de documentatie loop je daarmee direct risico op domain takeover (overname van je domein), zelfs als je het domein hebt geverifieerd. Maak liever records aan voor de specifieke subdomeinen die je gebruikt.

Kort antwoord: Ga in je repository naar Settings > Pages (Instellingen > Pages), typ je domein bij Custom domain (Eigen domein) en sla op. Laat daarna bij je DNS-provider www met een CNAME-record naar <username>.github.io wijzen, en laat het kale domein (example.com) met vier A-records naar GitHub wijzen. Als GitHub het certificaat heeft uitgegeven, vink je Enforce HTTPS aan. Het is dus één instelling in de repo plus een paar DNS-records. De meeste vertraging komt door DNS-propagatie, die volgens GitHub tot 24 uur kan duren.

Alles hieronder is in november 2026 gecontroleerd aan de hand van de eigen documentatie van GitHub. DNS-waarden veranderen het vaakst, dus controleer ze in de documentatie over eigen domeinen van GitHub Pages voordat je ze plakt.

Kies eerst je domeintype

Hier wil je dat bezoekers landen	Instellen als eigen domein	Benodigde DNS-records	Opmerkingen
`www.example.com`	`www.example.com`	CNAME op `www` naar `<username>.github.io`, plus A-records op de apex	De aanbevolen opzet van GitHub. `example.com` verwijst door naar www.
`example.com`	`example.com`	A-records op de apex (of één ALIAS/ANAME), plus een CNAME op `www`	`www.example.com` verwijst door naar de apex.
`blog.example.com`	`blog.example.com`	CNAME op `blog` naar `<username>.github.io`	Geen apex-records nodig.

Volgens de documentatie van GitHub zijn www-subdomeinen de stabielste keuze, omdat ze niet worden beïnvloed door wijzigingen in de IP-adressen van de servers van GitHub. Heb je geen sterke reden voor het kale domein, kies dan www. Zoek je nog een registrar? Dan staan de opties in onze vergelijking van domeinregistrars, en wat een domein kost legt de verlengingsprijzen uit.

Stap voor stap: het domein koppelen

Voeg het domein toe in GitHub. Open je repository, klik op Settings en dan op Pages (onder "Code, planning, and automation"). Zie je het tabblad Settings niet, kijk dan in het uitklapmenu "More". Typ je domein in het veld Custom domain en klik op Save.
Controleer wat GitHub in je repo heeft gedaan. Publiceer je vanaf een branch, dan commit GitHub een CNAME-bestand in de root van die branch. Publiceer je met een eigen GitHub Actions-workflow, dan wordt er geen CNAME-bestand aangemaakt en wordt een bestaand bestand genegeerd.
Verwijder standaard DNS-records. Heeft je DNS-provider automatisch een parkeer- of standaardrecord aangemaakt voor de host die je gaat gebruiken, verwijder dat dan eerst.
Maak de DNS-records aan bij je DNS-provider (zie het volgende onderdeel).
Wacht op propagatie. GitHub noemt maximaal 24 uur. Je kunt de voortgang vanuit een terminal controleren met dig www.example.com +noall +answer.
Dwing HTTPS af zodra de optie beschikbaar komt (zie hieronder).

De volgorde maakt minder uit dan je denkt

Je kunt de DNS-records zowel voor als na het opslaan van het domein in GitHub aanmaken. Het risico is dat de DNS naar GitHub Pages wijst terwijl het domein door geen enkele repo is geclaimd. GitHub waarschuwt dat het instellen van DNS zonder het domein aan GitHub toe te voegen ertoe kan leiden dat iemand anders een site host op een van je subdomeinen. Sla het domein dus eerst op in GitHub en doe daarna de DNS.

De DNS-records

www of een ander subdomein: één CNAME

Type	Host	Waarde
CNAME	`www`	`<username>.github.io`

Gebruik je gebruikersnaam of organisatienaam, zonder de naam van de repository. GitHub zegt nadrukkelijk dat je de CNAME niet moet laten wijzen naar het unieke *.pages.github.io-adres dat in je repository-instellingen staat.

Apex-domein: vier A-records (gecontroleerd in november 2026)

Type	Host	Waarde
A	`@`	`185.199.108.153`
A	`@`	`185.199.109.153`
A	`@`	`185.199.110.153`
A	`@`	`185.199.111.153`

Optioneel IPv6, als je dat wilt, als AAAA-records op @:

Type	Host	Waarde
AAAA	`@`	`2606:50c0:8000::153`
AAAA	`@`	`2606:50c0:8001::153`
AAAA	`@`	`2606:50c0:8002::153`
AAAA	`@`	`2606:50c0:8003::153`

GitHub raadt aan de A-records ook toe te voegen als je AAAA-records instelt, omdat IPv6 nog niet overal wordt gebruikt. Ondersteunt je DNS-provider ALIAS- of ANAME-records, dan kun je in plaats van de A- en AAAA-records één record gebruiken dat naar <username>.github.io wijst.

Twee fouten die je moet vermijden:

Extra records op de apex. Volgens GitHub kunnen extra A-, AAAA-, ALIAS- of ANAME-records op @, of een CNAME op www die ergens anders naartoe wijst, voorkomen dat het HTTPS-certificaat wordt aangemaakt.
Een subdomein laten wijzen naar je apex. GitHub waarschuwt dat dit problemen geeft bij het afdwingen van HTTPS en ertoe kan leiden dat het subdomein je site helemaal niet meer bereikt. Laat subdomeinen wijzen naar <username>.github.io.

Sommige providers gebruiken @ voor de apex-host, andere willen dat je het veld leeg laat of het volledige domein typt. Dat is een eigenaardigheid van de provider, geen instelling van GitHub.

HTTPS inschakelen

GitHub geeft certificaten voor eigen domeinen uit via Let's Encrypt. Zodra de DNS goed resolvet:

Ga terug naar Settings > Pages.
Zoek een vinkje naast je domein. Dat betekent dat de DNS-controle is geslaagd.
Vink Enforce HTTPS aan.

Volgens GitHub kan het tot 24 uur duren voordat de optie beschikbaar is. Is die enkele minuten na het opslaan nog niet verschenen, dan is de door GitHub voorgestelde oplossing: klik op Remove naast het eigen domein, typ het opnieuw in en klik weer op Save. Het domein moet bovendien uit minder dan 64 tekens bestaan om een certificaat te kunnen krijgen.

Blijft het selectievakje grijs, loop dan deze lijst door:

[ ] De DNS voor de host resolvet naar GitHub (dig toont de vier IP's of je <username>.github.io-CNAME)
[ ] Geen extra A-, AAAA-, ALIAS- of ANAME-records op de apex
[ ] De www-CNAME wijst naar <username>.github.io, niet naar de apex of een pages.github.io-adres
[ ] Het domein in Settings > Pages komt exact overeen met wat je in DNS hebt ingevoerd
[ ] Je hebt het domein één keer verwijderd en opnieuw toegevoegd

Verifieer het domein (sterk aanbevolen)

Verificatie voorkomt dat andere GitHub-accounts je domein claimen als je Pages-site ooit wordt ontkoppeld. GitHub noemt domain takeover mogelijk wanneer je de repository verwijdert, wanneer je abonnement wordt gedowngraded, of na elke wijziging die het domein ontkoppelt terwijl het nog voor GitHub Pages is ingesteld en niet is geverifieerd.

Open de instellingen van je profiel (niet die van de repo) en kies in de zijbalk Pages.
Klik op Add a domain, voer het domein in en bevestig.
Maak het TXT-record aan dat GitHub toont. De host ziet eruit als _github-pages-challenge-USERNAME.example.com.
Controleer of het zichtbaar is met dig _github-pages-challenge-USERNAME.example.com +nostats +nocomments +nocmd TXT.
Gebruik in GitHub het menu naast het domein, kies Continue verifying en daarna Verify.

Volgens GitHub kan dit direct gaan of tot 24 uur duren. Laat het TXT-record daarna staan. Gebruik ook geen wildcard-records zoals *.example.com: volgens GitHub geven ze risico op overname, zelfs als het domein is geverifieerd.

Veelvoorkomende problemen

404 op het eigen domein, site werkt wel op github.io. Het domein is nooit opgeslagen in Settings > Pages, of de DNS is nog niet doorgevoerd. Controleer beide.
Het domein verdwijnt steeds na een deploy. Publiceer je vanaf een branch, dan moet het CNAME-bestand in de bronbranch je domein bevatten. Een build die de root van de branch leegmaakt, of een deploy die het bestand weglaat, kan het verwijderen. Overstappen op een eigen Actions-workflow maakt het bestand overbodig.
De apex werkt, www niet (of andersom). Beide hosts hebben records nodig. Onthoud dat GitHub de gekoppelde host alleen doorverwijst als ook diens DNS naar GitHub Pages wijst.
Het certificaat komt maar niet. Loop de checklist hierboven door en zoek eerst naar verdwaalde records.

Wil je DNS liever niet zelf beheren?

GitHub Pages past goed bij statische sites die je al in een repository bewaart. Wil je vooral een site online met je eigen domein, dan loodsen de eigen domeinen van We.Inc je door dezelfde DNS-stap binnen de builder, en de handleiding voor het koppelen van een domein behandelt het voor elke provider. Met het gratis abonnement van We.Inc publiceer je tot drie sites vanuit kant-en-klare templates. De AI-builder die op basis van een prompt een site opzet, begint bij het Starter-abonnement voor $20 per maand. Je kunt je hier aanmelden.

Gratis beginnen · Geen creditcard nodig

Umair Ali Sadaqat

Oprichter van We.Inc

Umair is de oprichter van We.Inc. Hij schrijft over websites bouwen met AI, bureaus en de bedrijfsvoering van een webstudio.

Klaar om iets moois te bouwen?

Sluit je aan bij 15,000+ bedrijven die We.Inc gebruiken om te lanceren, te groeien en te automatiseren, allemaal vanuit één platform.