githubdnsgithub-pagesa-records

GitHub Pages Custom Domain Settings

I'm trying to configure GitHub with my naked domain.com (APEX in GitHub) and www.domain.com.

I have username.github.io working OK.

My A record is pointing to 192.30.252.153 and 192.30.252.154.

I then have two CNAME records set:

This configuration, however, is not working.

Accessing domain.com results in a 404 on GitHub. Meanwhile, accessing www.domain.com results in an ERR_NAME_NOT_RESOLVED.

Existing documentation is confusing and there's no clear way of configuring things end-to-end.

Can someone tell me what I'm missing?

Solution

  • Here's what I've done to get domain.com and www.domain.com working you'll need this:

    1. An A record for www
    2. An A record @ 192.30.252.153
    3. An A record @ 192.30.252.154
    4. A CNAME aliasing www.domain.com to username.github.io. (note the trailing period)
    5. The "CNAME" file in the GitHub Pages repo contains the text "domain.com"

    I think the wildcard A record may be optional in your case but I'm not certain.

    Edit: Removed wildcard A record. @mheadroom pointed out that GitHub recommends against this entry because it would allow anyone to host a GitHub Pages site on one of your subdomains! https://help.github.com/articles/tips-for-configuring-a-cname-record-with-your-dns-provider/