Initial application setup

If a member of your team has already set up a GitHub Enterprise connection, you can skip to the Gearset setup section of this article.

Depending on your corporate firewall settings, you may need to allowlist logins from Gearset’s static IPs. Next, you will need to create a new OAuth application for Gearset to be able to access your GitHub Enterprise instance, by following these steps:

  1. Log in to GitHub Enterprise

  2. Go to the Applications page in your organisation’s settings. You may also need to navigate to Developer settings:

  3. Under OAuth Apps, click Register new application

  4. Enter Gearset as the Application name, https://gearset.com as the Homepage URL and https://app.gearset.com/authorization/github-enterprise/callback as the Authorization callback URL. Press Register application

Configure a GHE OAuth app for Gearset

Take note of the Client ID and the Client Secret.

Gearset setup

Now that you have your application Client ID and Client Secret, you can link Gearset with your GitHub Enterprise instance.

  1. Click + Connect to GitHub Enterprise

  2. Fill in the Url of your GitHub Enterprise instance (don’t forget HTTPS), the Client ID and Client Secret (from the earlier step)

  3. Press Connect. You will then go through the normal authentication flow from within GitHub Enterprise.

Once complete, you will be redirected back to Gearset and you should now be able to use GitHub Enterprise repositories as your source or target.

Anyone else in your team who wants to connect to GitHub Enterprise will need to follow the Gearset setup steps.

Did this answer your question?