10 Deploy your site

  1. In the top navigation bar, select Settings.

       See image
    Base repo, pointing at settings
  2. Then, go to the Pages sidebar option.

       See image
    Selecting pages from the settings page
  3. “Deploy from a branch” is already selected, which is what we want. We must change the branch from “none” to “main”. Select the “None” dropdown button and select “main”.

       See image

    Select main as the branch

  4. Change the folder from /root to /docs and press save.

       See image

    Select /docs as the branch

Great! Now we’re waiting on the page to build and deploy, which should take less than a minute.

10.1 Check your deploy and see your website!

To see updates, go to the Actions page (found along the top navigation bar. This will help you understand how the deploy is working, and if it succeeded or failed.

   See image

Image showing the different possibilities of deploy a github page

You can click pages build and deployment for updates.

   See image

where to click for pages build and deployment information

A successful deploy will have a green checkmark next to it. You can inspect the 3 steps: build, report-build-status, deploy. Once it’s done deploying, you can find the website at the link provided under the “deploy” step!

   See image

successful deploy

A failed deploy will have a red cross next to it. Clicking through the steps can help you determine what went wrong in the deploy.

   See image

failed deploy

Important!

Warning: A website can build properly, but may not deploy properly! It is a good idea to check after making big changes.

A very specific build and deployment warning

This is a very specific (and unlikely) warning. It occurs when 1 deploy hasn’t finished, but another deploy began. This is a warning message you do not have to worry about!

   See image

two consecutive deploy warnings