Hoe koppel ik mijn domein aan GitHub Pages?

Wat heb ik nodig voordat ik een domeinnaam aan GitHub Pages koppel?

DotAlmanac is een gids voor domeinextensies en een registrar: vergelijk elke extensie en registreer hem daarna zonder KYC en betaal in crypto. Om deze gids te volgen heb je drie dingen nodig.

• Een domeinnaam op de nameservers van DotAlmanac. Op het tabblad Nameservers van de domeinnaam moet "Our nameservers" staan. Gebruikt de domeinnaam andere nameservers, voeg dan dezelfde records toe bij die DNS-provider.
• Een repository met GitHub Pages ingeschakeld. Die kan publiceren vanuit een branch of vanuit een GitHub Actions-workflow.
• Je GitHub-gebruikers- of organisatienaam. Die gaat in het www-record. De repositorynaam nooit.

Veel ontwikkelaars kiezen .dev of .app voor een projectsite. Controleer eerst de verlenging: volgens het prijsoverzicht van DotAlmanac verlengt .dev 44% boven de eerstejaarsprijs en .app 67% erboven, per 29 oktober 2026. Een .dev kost US$ 8,99/jaar, daarna US$ 12,99/jaar. Beide extensies vereisen HTTPS, wat GitHub Pages levert. Vergelijk ze op .app vs .dev.

Kan ik de records in plaats daarvan als zonebestand plakken?

Ja. Open DNS › Import / export › Import zone file, kies "Add to existing records" en plak de regels hieronder. Vervang octocat door je eigen gebruikersnaam. De import leest standaard BIND-syntax, toont een voorbeeld en verstuurt niets voordat je opslaat.

@    3600  IN  A      185.199.108.153
@    3600  IN  A      185.199.109.153
@    3600  IN  A      185.199.110.153
@    3600  IN  A      185.199.111.153
@    3600  IN  AAAA   2606:50c0:8000::153
@    3600  IN  AAAA   2606:50c0:8001::153
@    3600  IN  AAAA   2606:50c0:8002::153
@    3600  IN  AAAA   2606:50c0:8003::153
www  3600  IN  CNAME  octocat.github.io.

Moet ik het kale domein of www gebruiken met GitHub Pages?

Stel beide in, en voer degene die je voorkeur heeft in de repository in. Als de records van de apex en van www correct zijn, leidt GitHub Pages de andere door naar die ene.

GitHub ondersteunt één apex-domein of één www-naam per site. Het ondersteunt geen twee apex-domeinen, twee www-namen of een apex gecombineerd met een ander aangepast subdomein. Voor een project op een subdomein, zoals docs.example.com, voeg je één CNAME toe van docs naar USERNAME.github.io en sla je de A-records over.

Hoe lang duurt het voordat mijn domein werkt op GitHub Pages?

Dat hangt af van de TTL van de records die resolvers vóór je wijziging zagen. TTL is het aantal seconden dat een resolver een antwoord in zijn cache houdt.

• Een naam zonder eerder record werkt zodra je opslaat.
• Een vervangen record houdt zijn oude waarde in sommige caches tot de oude TTL verstreken is. De templaterecords gebruiken 3600 seconden, dat is één uur.
• Plan een verhuizing vooruit: verlaag de TTL van de oude records een dag vooraf naar 300 seconden.

De eigen documentatie van GitHub zegt dat DNS-wijzigingen tot 24 uur kunnen duren voordat ze zijn doorgevoerd. Het HTTPS-certificaat komt nadat de DNS-controle is geslaagd.

Waarom zegt GitHub dat mijn domein niet goed is geconfigureerd?

In de meeste gevallen antwoordt nog een oud record voor dezelfde naam. Controleer deze punten in volgorde:

• Achtergebleven records. Een oud A-, AAAA- of ALIAS-record op @, of een parking-record, concurreert met die van GitHub. De template verwijdert ze; bij handmatige aanpassingen wordt er vaak één gemist.
• Repositorynaam in de CNAME. Het www-doel is alleen USERNAME.github.io.
• Wildcard-record. GitHub waarschuwt dat een record zoals *.example.com een risico op domeinovername creëert. Verwijder het.
• Andere nameservers. Als het domein een andere DNS-provider gebruikt, worden de records in het DNS-tabblad van DotAlmanac niet geserveerd.
• CAA-records. Als je CAA-records publiceert, vereist GitHub er minstens één met de waarde letsencrypt.org voor HTTPS.

Test het resultaat met dig example.com +short of een online DNS-lookup.