GitLab Pages DNS records
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
A Domain Name System (DNS) web service routes visitors to websites
by translating domain names (such as www.example.com
) into the
numeric IP addresses (such as 192.0.2.1
) that computers use to
connect to each other.
A DNS record is created to point a (sub)domain to a certain location, which can be an IP address or another domain. In case you want to use GitLab Pages with your own (sub)domain, you need to access your domain’s registrar control panel to add a DNS record pointing it back to your GitLab Pages site.
How to add DNS records depends on which server your domain is hosted on. Every control panel has its own place to do it. If you are not an administrator of your domain, and don’t have access to your registrar, you must ask the technical support of your hosting service to do it for you.
To help you out, we’ve gathered some instructions on how to do that for the most popular hosting services:
- 123-reg
- Amazon
- Bluehost
- Cloudflare
- cPanel
- DigitalOcean
- DreamHost
- Gandi
- Go Daddy
- Hostgator
- Inmotion hosting
- Microsoft
- Namecheap
If your hosting service is not listed above, you can just try to
search the web for how to add dns record on <my hosting service>
.
A
record
A DNS A
record maps a host to an IPv4 IP address.
It points a root domain as example.com
to the host’s IP address as
192.192.192.192
.
Example:
example.com
=>A
=>192.192.192.192
CNAME
record
CNAME
records define an alias for canonical name for your server (one defined
by an A
record). It points a subdomain to another domain.
Example:
www
=>CNAME
=>example.com
This way, visitors visiting www.example.com
are redirected to
example.com
.
MX
record
MX records are used to define the mail exchanges that are used for the domain. This helps email messages arrive at your mail server correctly.
Example:
MX
=>mail.example.com
Then you can register emails for users@mail.example.com
.
TXT
record
A TXT
record can associate arbitrary text with a host or other name. A common
use is for site verification.
Example:
example.com
=>TXT
=>"google-site-verification=6P08Ow5E-8Q0m6vQ7FMAqAYIDprkVV8fUf_7hZ4Qvc8"
This way, you can verify the ownership for that domain name.
All combined
You can have one DNS record or more than one combined:
example.com
=>A
=>192.192.192.192
www
=>CNAME
=>example.com
MX
=>mail.example.com
example.com
=>TXT
=>"google-site-verification=6P08Ow5E-8Q0m6vQ7FMAqAYIDprkVV8fUf_7hZ4Qvc8"
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support