Web Development

  1. Github Pages project on custom subdomain

Github Pages project on custom subdomain

First, enable GitHub pages for your repository under the settings. If you’re using Jekyll and want Github to compile the site, set the source to “master branch”. If you’re compiling it yourself and pushing it to the gh-pages branch, choose that.

Then under “Custom domain,” set your subdomain, such as (Look familiar?) This will create a commit to your repository with a CNAME file that will let GitHub handle properly directing requests to your domain.

Now go to your domain provider’s site to add a custom DNS record. Choose the type as CNAME and set the name to your subdomain (e.g., docs). Then under the Domain name/data, set your GitHub Pages base url with a period at the end, such as Note that this does not include your project’s repository name at the end.

It can take awhile (up to hours) for this to propagate. You can check whether it’s working with:

dig +nostats +nocomments +nocmd

It should give an output like this:

; <<>> DiG 9.11.3-1ubuntu1.7-Ubuntu <<>> +nostats +nocomments +nocmd
;; global options: +cmd
;           IN      A    3519    IN      CNAME      1816    IN      A      1816    IN      A      1816    IN      A      1816    IN      A

If you don’t have any lines not starting with ;, it means it’s not working (or not working yet).

A final note if you’re using Jekyll: when you’re set up with the subdomain instead of, you will set the base_url in your _config.yml to nothing instead of /PROJECT-NAME.