Skip to main content

Configuring GitHub Pages for your enterprise

You can enable or disable GitHub Pages for your enterprise and choose whether to make sites publicly accessible.

Enabling public sites for GitHub Pages

If private mode is enabled on your enterprise, the public cannot access GitHub Pages sites hosted by your enterprise unless you enable public sites.

Warning: If you enable public sites for GitHub Pages, every site in every repository on your enterprise will be accessible to the public.

  1. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

    Screenshot of the rocket ship icon for accessing site admin settings

  2. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

    Screenshot of "Site admin" link

  3. In the left sidebar, click Management Console. Management Console tab in the left sidebar

  4. In the left sidebar, click Pages. Pages sidebar

  5. Select Public Pages. Checkbox to enable Public Pages

  6. Under the left sidebar, click Save settings.

    Screenshot of the save settings button in the Management Console

    Note: Saving settings in the Management Console restarts system services, which could result in user-visible downtime.

  7. Wait for the configuration run to complete.

    Configuring your instance

Disabling GitHub Pages for your enterprise

If subdomain isolation is disabled for your enterprise, you should also disable GitHub Pages to protect yourself from potential security vulnerabilities. For more information, see "Enabling subdomain isolation."

  1. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

    Screenshot of the rocket ship icon for accessing site admin settings

  2. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

    Screenshot of "Site admin" link

  3. In the left sidebar, click Management Console. Management Console tab in the left sidebar

  4. In the left sidebar, click Pages. Pages sidebar

  5. Unselect Enable Pages. Checkbox to disable GitHub Pages

  6. Under the left sidebar, click Save settings.

    Screenshot of the save settings button in the Management Console

    Note: Saving settings in the Management Console restarts system services, which could result in user-visible downtime.

  7. Wait for the configuration run to complete.

    Configuring your instance

Configuring GitHub Pages response headers for your enterprise

You can add or override response headers for GitHub Pages sites hosted by your GitHub Enterprise Server instance.

Warning: Ensure that your response headers are properly configured before saving. Improper configurations may negatively impact the security of your GitHub Enterprise Server instance.

  1. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

    Screenshot of the rocket ship icon for accessing site admin settings

  2. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

    Screenshot of "Site admin" link

  3. In the left sidebar, click Management Console. Management Console tab in the left sidebar

  4. In the left sidebar, click Pages. Pages sidebar

  5. Type the headers settings, then click Add headers.

    • In the Http Header Name field, type the header name. The length of header name should less than 128 characters.
    • In the Http Header Value field, type the header value. The length of header value should less than 300 characters. The GitHub Pages response header name and value fields in the Management Console
  6. Under the left sidebar, click Save settings.

    Screenshot of the save settings button in the Management Console

    Note: Saving settings in the Management Console restarts system services, which could result in user-visible downtime.

  7. Wait for the configuration run to complete.

    Configuring your instance

Further reading