So you want to make a site with GitHub

Tell me where you want to publish it, and I'll give you the instructions:

  1. Site location: .github.io/

  2. Site location:

To publish a site on , you will need to:

  1. Create a GitHub repository with the name ;

  2. Push the site contents to the master branch of that repository.

To publish a site on , you will need to:

  1. Own the domain name;

  2. Using your DNS provider, do one of the following to connect to GitHub:

    • If your DNS provider supports it, create an ALIAS or ANAME record for and map it to username.github.io.

    • Otherwise, create two A records for and map them to these IPs:

      1. 192.30.252.153
      2. 192.30.252.154

  3. (Optional) You should also allow people to reach your site at www.. To enable that, do the following using your DNS provider:

    • Create a CNAME record for www and map it to .

  4. (Optional) If your DNS provider supports creating ALIAS or ANAME records, consider hosting your site at (without the www subdomain). This will make it easier for visitors to type your domain name in their browser's URL bar.

  5. Using your DNS provider, create a CNAME record for and map it to username.github.io;

  6. Create a GitHub repository under your GitHub account;

  7. Push the site contents to the gh-pages branch of that repository.

  8. Add a CNAME file in that repository with this content: .