Github allows you to host a static website on its servers. The benefit is that because it is a static site it can take advantage of their CDN and it is fast. The downside (if you choose to see it as one) is that it is a static site - no database, no server side interaction. Basically read only. Personally I love it and it becomes very useful when using Jekyll to generate the site for you.
Below I’ll go through the very basic steps of setting up a site on github.io and pointing your domain to it
To create your first site you’ll need to create a new repo on Github called
username.github.io (where username is your Github username). In the
add and commit an
index.html file. Add a line of text in there so you’ll know it is working:
Once you pushed these changes point your browser to
http://<username>.github.io and you should see the index file displayed.
Add and commit a new file called
CNAME to your repo with a single line of text that points to your site:
The following will differ depending on your hosting provider where the domain is parked but the gist of it is the same in that you need to update your A or C record to point to github. At the time of writing the IP was 126.96.36.199.
Name | Type | Record --------------|------|--------------- yoursite.com. | A | 188.8.131.52
That should be all. If you point your browser to
http://www.yoursite.com you’ll see your site displayed. Free hosting!
Any other repo (let’s call it
popcorn) you may have can be used to host a website. What you’ll need to do is create a
gh-pages branch and commit your site to it.
It will then be accessible through
However, what if you want to host multiple sites on one github account? In your
gh-pages branch, add another CNAME file and repeat step 2 above but using your
Once done you should have two repos each with its own domain:
http://www.yoursite.com in the
master branch of
http://www.popcorn.com in the
gh-pages branch of