Custom Domein op GitLab Pages Instellen – De Complete Handleiding
Je hebt je GitLab Pages site draaien, maar het standaard jouw-project.gitlab.io adres oogt niet professioneel. De oplossing: koppel je eigen domein. In deze handleiding doorloop ik alle stappen — van DNS-configuratie tot SSL-verificatie.
Een custom domein is essentieel voor affiliate sites: het bouwt vertrouwen, versterkt je merk en is beter voor SEO.
Inhoud
1. Waarom een Custom Domein?
Een custom domein (bijv. jouwsite.nl) in plaats van jouw-project.gitlab.io biedt drie grote voordelen:
Vertrouwen
Bezoekers vertrouwen een professioneel domein meer dan een subdomein van een derde partij.
SEO
Een eigen domein bouwt domeinautoriteit op. Backlinks wijzen naar jouw merk, niet naar gitlab.io.
Branding
Herkenbare URL's maken je site professioneler en makkelijker te onthouden.
Voor affiliate marketing sites is een custom domein eigenlijk een must — het laat zien dat je serieus bent.
2. Domein Registreren
Als je nog geen domein hebt, registreer er een bij een betrouwbare registrar. Populaire opties voor Nederlandse gebruikers:
- TransIP – .nl domeinen vanaf €4,99/jaar. Bekende Nederlandse registrar met goede DNS-management tools.
- Cloudflare Registrar – Domeinen tegen kostprijs (geen marge). Uitstekende DNS met gratis extra features.
- Versio – Budget-optie voor .nl en internationale extensies.
Tip: Kies een .nl domein als je je richt op de Nederlandse markt, of .com voor internationaal. Vermijd exotische extensies — die worden minder vertrouwd.
3. DNS Records Instellen
DNS records vertellen het internet waar jouw domein naartoe moet wijzen. Je hebt twee records nodig:
Let op: Het IP-adres voor het A-record kan wijzigen. Controleer altijd de officiële GitLab documentatie voor het actuele IP.
4. Domein Toevoegen in GitLab
Nu je DNS is ingesteld, voeg je het domein toe aan je GitLab project:
- Open je project op GitLab en ga naar Deploy → Pages
- Klik op "New Domain" rechtsboven
- Voer je domein in (bijv.
jouwsite.nl) zonder http:// of www - Klik op "Create New Domain"
GitLab toont nu een verificatiecode — een TXT-record dat je aan je DNS moet toevoegen om te bewijzen dat het domein van jou is.
5. DNS-Verificatie Voltooien
Voeg het verificatie-TXT record toe bij je DNS provider:
Na het toevoegen:
- Wacht 10-30 minuten voor DNS-propagatie
- Ga terug naar GitLab → Pages → klik "Retry verification"
- Bij succes zie je een groen vinkje naast je domein
Pro tip: Gebruik dnschecker.org om te controleren of je DNS-records wereldwijd zijn gepropageerd voordat je op retry klikt.
6. SSL Certificaat Activeren
Zodra je domein is geverifieerd, genereert GitLab automatisch een gratis Let's Encrypt SSL-certificaat. Dit kan 10-30 minuten duren.
Wat je krijgt
- • Gratis SSL/TLS certificaat
- • Automatische vernieuwing elke 90 dagen
- • HTTPS op je custom domein
- • HTTP → HTTPS redirect
Veel voorkomende fouten
- • DNS nog niet gepropageerd
- • CAA record blokkeert Let's Encrypt
- • Cloudflare proxy aan (zet op DNS Only)
- • Verkeerd IP in A-record
Controleer of SSL werkt door https://jouwsite.nl te openen. Je zou een slotje in de adresbalk moeten zien.
7. Primary Domain en Redirects
De laatste stap: stel je custom domein in als Primary Domain. Dit zorgt ervoor dat het oude gitlab.io adres automatisch redirect naar jouw domein.
- Ga naar Settings → Pages in je GitLab project
- Zoek je custom domein in de lijst
- Klik op de drie puntjes (...) en kies "Set as Primary Domain"
Nu redirect jouw-project.gitlab.io met een 308 Permanent Redirect naar jouwsite.nl. Dit voorkomt duplicate content en consolideert je SEO-signalen naar één domein.
Best practice: Zet je canonical tags, og:url tags en sitemap.xml ook allemaal op je custom domein. Consistentie is key voor SEO.
8. Troubleshooting
De meest voorkomende problemen en oplossingen:
"Domain verification failed"
Controleer het TXT-record bij je DNS provider. De naam moet exact overeenkomen met wat GitLab aangeeft. Wacht minimaal 30 minuten na het toevoegen.
"SSL provisioning failed"
Zorg dat je A-record naar het correcte GitLab Pages IP wijst. Als je Cloudflare gebruikt, zet de proxy op "DNS Only" (grijs wolkje) tijdens het instellen.
Site laadt maar toont 404
Je CI/CD pipeline heeft mogelijk geen public/ folder aangemaakt. Controleer dat je .gitlab-ci.yml correct is en dat de pipeline succesvol is afgerond.
www werkt niet, root domein wel
Je CNAME record voor www ontbreekt of wijst naar het verkeerde adres. Het moet wijzen naar jouw-project.gitlab.io (niet het IP).
💬 Veelgestelde Vragen
Kost een custom domein op GitLab Pages extra?
Nee, het koppelen is gratis. Je betaalt alleen de domeinregistratie (±10-15 euro/jaar).
Hoe lang duurt het voordat mijn domein werkt?
DNS-propagatie duurt meestal 1-4 uur, soms tot 48 uur. SSL-certificaat wordt automatisch aangevraagd na verificatie.
Kan ik zowel www als non-www gebruiken?
Ja. Stel het primaire domein in en maak een CNAME voor www. GitLab Pages handelt beide varianten af.
Krijg ik gratis SSL bij een custom domein?
Ja, GitLab genereert automatisch een gratis Let's Encrypt certificaat dat elke 90 dagen wordt vernieuwd.
Wat als mijn DNS-verificatie faalt?
Controleer het TXT-record, wacht minimaal 1 uur, en gebruik dnschecker.org om te verifiëren dat het record correct is.
Werkt een custom domein ook met subdomeinen?
Ja, elk subdomein (bijv. blog.jouwsite.nl) heeft een eigen CNAME-record nodig dat naar je GitLab Pages URL wijst.
Moet ik de gitlab.io URL redirecten?
Ja, stel je custom domein in als Primary Domain in GitLab Settings → Pages. Dit maakt een automatische 308-redirect.
Welke DNS provider raden jullie aan?
Cloudflare is populair vanwege gratis DNS en snelle propagatie. TransIP en Versio zijn goede Nederlandse alternatieven.
Lees Verder
Je Eigen Domein — In Minuten Online
Start met gratis hosting en koppel je eigen domein. Geen technische kennis nodig, geen maandelijkse kosten.
Start Gratis met GitPage