Skip to content

Pages - Do not suggest adding CNAME DNS Resource Record to naked domain for custom domains

When setting up a custom domain for GitLab Pages on GitLab.com, GitLab Pages UI instructs the administrator to add a CNAME DNS resource record to the target custom domain zone, pointing to the standard gitlab.io subdomain. This is incorrect, however, when the custom domain zone contains other resource records as well. For this situation, the ALIAS record type exists.

See: https://help.ns1.com/hc/en-us/articles/360020248973.

Places where this is referenced:

UI Docs
Screenshot_2021-06-30_at_20.19.27 https://docs.gitlab.com/ee/user/project/pages/custom_domains_ssl_tls_certification/#requirements

Proposed solution

Be more nuanced in the instruction. Suggest to either use a CNAME or ALIAS record, depending on the situation.

Edited by Achilleas Pipinellis