How to add Custom Domain to GitHub Pages Blog
You decided to go with the GitHub pages for your blog and now you want to start writing your first post about some cool new technology you just learned about.
You can’t wait to share it with your friends and followers on Twitter, LinkedIn, Medium, and Facebook.
Then it hits you, the current domain name you have is underwhelming. In the previous post, we set up the site with the default repository name.
You think to yourself I’m a professional I don’t want to share it like that!
So you run out and get your super awesome domain name from GoDaddy for .99¢ and are stumped as to how you get it working with your new blog.
You have come to the right spot because I will walk you through the steps to add your custom domain to your GitHub Pages Blog site.
Let’s do this
Now it’s time to give your site that professional look.
This will be a quick process to complete!
- Configure DNS settings for a custom domain
- Update the Blog settings
- Update the _config.yml file
- Verify the Blog is using the custom domain
Configure DNS settings
You need to go to the company that you bought the domain name from and change the DNS settings.
Since the admin pages will look different from other providers you may need to find the help documentation on their site.
This is what the GoDaddy DNS Management page looks like when it is all configured.
Here is how you will create each of the A records. When making DNS changes it could take as long as 24 hours for them to be established.
Make sure there is the CNAME record to allow users to reach your site when they use the www domain prefix.
Update Blog settings
This step is crazy simple!
Go to the settings tab for the repository and enter in your Custom domain name.
Then click the Save button.
Update the _config.yml
In the main configuration file, _config.yml, you have to update the url and prod_url values.
Verify the Blog
You will want to make sure the blog built successfully before trying to load it in a browser.
Parting Thoughts - Commit to Content
Now that you have the custom domain added to your GitHub pages blog you are ready to confidently share your site with everyone you know!
Sharing your goals with others is a great way to help hold yourself accountable. The fact that you told your friends and family what you plan on doing you will be more likely to follow through.
Set a day each week to write one blog post. Get in a routine for a couple of months, then try to increase how many you are writing a week.
You have your Github Pages blog post content ready to go, but aren’t sure how to put that in your site. Follow these steps to get your post live!
Start a free blog to share your experiences with the world. You can do this for free thanks to GitHub!
5 Reasons to start blogging today. You can do this for free thanks to GitHub!