Next & Previous

Host HTML on GitHub Pages without using git

This is a companion post for easy and free ways to host a static website. Here’s how you can use the GitHub web interface to make a new HTML website without touching git or the command line!

Open GitHub in your browser, login (or make an account and login) then go to New Repository

Clicking on new repository

Enter some details for the repository and click on Create - you don’t need to initialise it with any files.

Setting up a new repository

When it’s created, you’ll see the Quick Setup screen. Click on the link to create a README file, we’re going to use it to make an index.html instead.

Clicking on the link to create a new README file

Now you’re in a file editor. Change the filename to index.html and put your HTML in the file content. You can borrow the HTML I wrote. When you’re done, scroll down and click on the ‘Commit’ button.

Adding file content

You’ll be taken back to the repository files view. Click on the repo ‘Settings’ cog.

Going to settings from the repository page

Scroll down to GitHub Pages, open the dropdown, and choose the ‘master’ branch. Then click ‘Save’

Configuring GitHub Pages to use the master branch

When you’re done, scroll back down to that section and it will now have a link to your site. For me, it’s You can use this config section to set up custom domains to point to your site!

Here’s one I made earlier:

The finished site in the browser

This works like any HTML site, and you can add more HTML, CSS, images, and JavaScript by using the ‘Create new file’ or ‘Upload files’ buttons on the repository front page.