Setting Up GitHub Pages

GitHub Pages is a free service offered by GitHub that allows you to create a website or blog for your project, personal brand, or business. By default, GitHub Pages provides a subdomain for your site, such as username.github.io. However, you can also use a custom domain name for your site, which can help you establish your brand and make your site more memorable.

In this tutorial, we will guide you through the steps to set up GitHub Pages with a custom domain.


Before you begin, you will need the following:

  • A GitHub account
  • A GitHub repository with your website files
  • A custom domain name that you own

Create a CNAME file

The first step is to create a CNAME file in the root of your repository. This file tells GitHub Pages which domain name to use for your site. To create the CNAME file, follow these steps:

  • In your local repository, create a new file named CNAME (all uppercase).
  • Open the file in a text editor.
  • Add your custom domain name on a new line, without any prefixes like "http://" or "www". Then save the file.

For example, if your custom domain is "example.com", the contents of the file should be:


Configure DNS settings

The next step is to configure the DNS settings for your custom domain name. You will need to add two DNS records: one for the root domain (e.g., example.com) and one for the www subdomain (e.g., www.example.com).

Here's how to do it:

  • Log in to your domain registrar's website and navigate to the DNS settings for your domain.
  • Create a new A record with your root domain (e.g., example.com) as the host and the IP address
  • Create three more A records with your root domain as the host and the following IP addresses:

These four IP addresses belong to GitHub's servers, and they are used to host your website files.

Note: The DNS changes may take some time to propagate, so it may take a few hours for your custom domain to start working with GitHub Pages.

Update GitHub Pages settings

The final step is to update the GitHub Pages settings for your repository to use your custom domain name.

Here's how to do it:

  • In your GitHub repository, click on "Settings" at the top.
  • Scroll down to the "GitHub Pages" section.
  • Under "Custom domain", enter your custom domain name (e.g., example.com).
  • Click "Save". After a few minutes, your website should be accessible using your custom domain name.


Congratulations! You have successfully set up GitHub Pages with a custom domain. With this setup, you can create a professional-looking website or blog that reflects your brand or business.



Be the first to comment!

Read More

JS Chunk Array

Here's a simple function that uses generators to chunk an array. Generators are a type of function that returns an iterator and traverse it one at a time if you u...

Node JS Logo
Node JS Logo

Setting up Node.JS for production

Node.js is a popular JavaScript runtime that allows developers to build server-side applications with JavaScript. PM2 is a process manager for Node.js applications that helps to keep your applications running smoothly and automatically restart th...

CSS Marquee Replacement

The HTML marquee tag, which was used to create scrolling text or images on a web page, has been deprecated and is no longer supported in modern web development. This means that while it may still work in some older web browsers, it is not considered a valid ...

Promises VS Callbacks

Promises and callbacks are both ways to handle asynchronous code in JavaScript. A callback is a function passed as an argument to another function and executed after the first function has been completed. A Promise is an object that is returned immediately, representing a value that may not be available yet. Promises are more powerful than callbacks because they provide a way to compose asynchronous operations and methods to handle errors. Promises...