docs/content/admin/configuring-settings/configuring-github-connect/enabling-github-connect-for-ghecom.md

title, shortTitle, intro, versions

title	shortTitle	intro	versions
Enabling GitHub Connect for GHE.com	Enable for GHE.com	Enable {% data variables.product.prodname_github_connect %} to share data between {% data variables.enterprise.data_residency_site %} and {% data variables.location.product_location %}.	feature ghecom-github-connect

You can access additional features and workflows on {% data variables.location.product_location %} by enabling {% data variables.product.prodname_github_connect %}. See "AUTOTITLE."

On {% data variables.enterprise.data_residency_site %}, {% data variables.product.prodname_github_connect %} features do not include any functionality that relies on resources on {% data variables.product.prodname_dotcom_the_website %}.

What happens when {% data variables.product.prodname_github_connect %} is enabled?

{% data reusables.github-connect.what-happens-when-enabled %}

Prerequisites

• Administrative access: You need administrative access to both an enterprise account on {% data variables.enterprise.data_residency_site %} and a {% data variables.product.prodname_ghe_server %} instance.

• Version requirement: Your {% data variables.product.prodname_ghe_server %} instance must run {% data variables.product.prodname_ghe_server %} 3.12 or later.

• Proxy configuration: If using a proxy server, allow connectivity to the following {% data variables.enterprise.data_residency_site %} hostnames (replace SUBDOMAIN with your enterprise's subdomain).

  • {% data variables.enterprise.data_residency_domain %}
  • {% data variables.enterprise.data_residency_api %}
  • uploads.{% data variables.enterprise.data_residency_domain %}

  See "AUTOTITLE."

Step 1: Enable connection to {% data variables.enterprise.data_residency_site %}

By default, {% data variables.product.prodname_github_connect %} connects {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_dotcom_the_website %}. You must enable your instance to connect to your enterprise's subdomain of {% data variables.enterprise.data_residency_site %}.

To enable the connection, someone with administrative SSH access to {% data variables.location.product_location_enterprise %} must complete the following tasks.

{% data reusables.enterprise_installation.ssh-into-instance %}

1. To enable your instance to connect to {% data variables.enterprise.data_residency_site %} for {% data variables.product.prodname_github_connect %}, run the following command. Replace SUBDOMAIN with the subdomain for your enterprise on {% data variables.enterprise.data_residency_site %}, for example octocorp.

   ghe-config app.github.github-connect-ghe-com-enabled true
   ghe-config app.github.github-connect-ghe-com-subdomain "SUBDOMAIN"
   

2. To apply the configuration, run the following command.

   [!NOTE] During a configuration run, services on {% data variables.location.product_location_enterprise %} may restart, which can cause brief downtime for users.

   ghe-config-apply
   

After the run completes, you can configure {% data variables.product.prodname_github_connect %}.

Step 2: Enable {% data variables.product.prodname_github_connect %}

To enable {% data variables.product.prodname_github_connect %}, you must be an enterprise owner on both {% data variables.product.product_name %} and {% data variables.product.prodname_ghe_cloud %}.

People with a user account in both environments can connect the accounts from {% data variables.location.product_location_enterprise %}.

1. Sign in to {% data variables.location.product_location %} and {% data variables.enterprise.data_residency_site %}. {% data reusables.github-connect.enable-github-connect %}
2. Choose which individual features of {% data variables.product.prodname_github_connect %} you want to enable. See "AUTOTITLE."

Reenabling connections to {% data variables.product.prodname_dotcom_the_website %}

If you need to reenable {% data variables.product.prodname_github_connect %} for {% data variables.product.prodname_dotcom_the_website %}, you must reconfigure your settings.

{% data reusables.enterprise_installation.ssh-into-instance %}

1. Run the following command.

   ghe-config app.github.github-connect-ghe-com-enabled false
   

2. To apply the configuration, run the following command.

   [!NOTE] During a configuration run, services on {% data variables.location.product_location_enterprise %} may restart, which can cause brief downtime for users.

   ghe-config-apply
   

3. Enable {% data variables.product.prodname_github_connect %} on {% data variables.product.prodname_dotcom_the_website %}. See "AUTOTITLE."