Article version: Enterprise Server 2.17

User, Organization, and Project Pages

There are two basic types of GitHub Pages sites: Project Pages sites, and User and Organization Pages sites. They are nearly identical but have some important differences.

GitHub Pages is available in public repositories with GitHub Free, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.

Project Pages sites are connected to a specific project, and the site files live on a branch within the project repository. User and Organization Pages sites are not tied to a specific project, and the site files live in a special repository dedicated to GitHub Pages files.

Warning: If the URL for your GitHub Pages site contains a username or organization name that begins or ends in a dash, or contains consecutive dashes, then people browsing with Linux will receive a server error when they visit the site. To fix this, change your GitHub Enterprise username to remove non-alphanumeric characters. For instructions on how to do this, see "Changing your GitHub username."

Project Pages sites

The source files for Project Pages sites live within the same repository as their project, and they are published from one of the following locations:

For more information, see "Configuring a publishing source for GitHub Pages."

Building Project Pages sites

Both personal and organization accounts can create Project Pages sites, and the steps for creating Project Pages sites are the same for both.

If subdomain isolation is enabled on your GitHub Enterprise Server instance, Project Pages sites are available in the following locations after they're built:

If subdomain isolation is not enabled on your GitHub Enterprise Server instance, Project Pages sites are available in the following locations after they're built:

For more information, see "Enabling subdomain isolation" or contact your site administrator.

User and Organization Pages sites

The source files for User and Organization Pages sites live on the master branch in a dedicated repository named with the GitHub Enterprise account name:

Building User and Organization Pages sites

If subdomain isolation is enabled on your GitHub Enterprise Server instance, User and Organization Pages sites are available in the following locations after they're built:

If subdomain isolation is not enabled on your GitHub Enterprise Server instance, User and Organization Pages sites are available in the following locations after they're built:

For more information, see "Enabling subdomain isolation" or contact your site administrator.

User Pages sites can be built by any user account. They can also use deploy keys to automate the process. For more information, see "Managing deploy keys" in the GitHub Developer documentation.

Organization Pages sites can be built by any member with push access to the repository. To automate builds, you can set up a machine user as a member of your organization. For more information, see "Managing deploy keys." Deploy keys aren't supported for Organization Pages sites.

Further reading

Ask a human

Can't find what you're looking for?

Contact us