Getting started with GitHub Pages

You can use GitHub Pages to host a website about yourself, your organization, or your project directly from a repository on GitHub.

You can create a GitHub Pages site in a new or existing repository.

Learn about the limits and limitations of GitHub Pages.

You can take advantage of using GitHub Actions and GitHub Pages by creating a workflow file or choosing from the predefined workflows.

You can configure your GitHub Pages site to publish when changes are pushed to a specific branch, or you can write a GitHub Actions workflow to publish your site.

A privately published GitHub Pages site is only available to people with read access to its repository. Learn how access and URLs work for these sites, and what happens to them if your organization's plan changes.

You can delete a GitHub Pages site.

You can unpublish your GitHub Pages site so that your current deployment is removed and the site is no longer available. This is different from deleting the site.

You can manage access control for your project site by publishing the site publicly or privately.

You can display a custom 404 error page when people try to access nonexistent pages on your site.

HTTPS adds a layer of encryption that prevents others from snooping on or tampering with traffic to your site. You can enforce HTTPS for your GitHub Pages site to transparently redirect all HTTP requests to HTTPS.

You can use submodules with GitHub Pages to include other projects in your site's code.

This guide will help you troubleshoot common reasons you may be seeing a 404 error.