DEV Community

Cover image for Connecting Namecheap Domain with GitHub Pages
Harish for Right From Basics

Posted on • Updated on • Originally published at

Connecting Namecheap Domain with GitHub Pages

A basic tutorial for those who are looking to connect their custom domain to GitHub Pages. This post assumes you will be getting your domain with Namecheap. But, it should mostly apply to any domain providers.

I first used Namecheap because they offered students free domains. Yup, if you are a student you can get a free Namecheap domain ending with `.me’ free for a year. Check their offer here.

1. Register on Namecheap

Simply go to the Namecheap homepage and register for an account.

2. Select a cool domain

Try to get a .com domain. It is the most general and commonly used domain. But with a ton of websites floating online, you may not be able to find your ideal domain available under .com. If thats the case check out .me domains for a personal website (like mine), the trendy .io for a startup/business, .net. Namecheap offers a wide range of domains to choose from. Some of them are .life, .co, .tech etc.

Choose the domain carefully as you will be sticking with it for some considerable time.

3. Get a GitHub Repository

If you have not yet created a repository, go to GitHub to create one. Name it <your-github-username> and ensure you have a master branch where you can push your HTML files. I assume you have your HTML, CSS, JavaScript files ready. Push them to this repository on the master branch.

Visit the website <your-github-username> should allow you to view the expected website.

4. Create a CNAME record in your Repository

Create a file titled CNAME with your domain name. That’s it. For example my CNAME file contains this:

5. Go to Namecheap’s Dashboard

Under the Advanced DNS section, add in the following records. The CNAME record's value follows the GitHub URL you made in step 3. The A records are used to point the domain name to the IP address of the hosting server, which in your case will be GitHub’s.

Namecheap Records

That’s all folks. Give it a few minutes (or hours) and your site will be live at your newly registered domain.

Looking for Hosting?

Both services offer great uptime and customer service. Oh did I mention - you get a free domain name with both Bluehost and Hostinger!

Top comments (1)

alexandraalexandru profile image

Thank you very much! this was very useful. All the other sources I found didn't mention creating the CNAME file in the repo. Now it works :D