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:
Log in to GitHub Enterprise
Go to the
Applications
page in your organisation’s settings. You may also need to navigate toDeveloper settings
:Under
OAuth Apps
, clickRegister new application
Enter
Gearset
as theApplication name
, https://gearset.com as theHomepage URL
and https://app.gearset.com/authorization/github-enterprise/callback as theAuthorization callback URL
. PressRegister application
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.
Navigate to the Source control and services page
Click
+ Connect to GitHub Enterprise
Fill in the
Url
of your GitHub Enterprise instance (don’t forget HTTPS), theClient ID
andClient Secret
(from the earlier step)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.