GitHub Enterprise Server
Gitpod works well with public, private, or internal repositories from your own instance of GitHub Enterprise (GHE).
Registering a GitHub Enterprise Integration
As an organization owner, you can configure Gitpod with your GitHub Enterprise instance via the following steps:
On Gitpod’s Dashboard:
- Navigate to the Organization settings using the organization dropdown in the top left corner.
- Select
Git Providers
and clickNew Git Provider
. - Choose
GitHub
as the provider type and enter your GHE hostname. - Copy the redirect URL from the form and follow the instructions below to create a corresponding OAuth app on GitHub Enterprise.
On your GitHub Enterprise Server instance:
- Open your GitHub Enterprise Developer settings.
- Go to
OAuth Apps
and create a new OAuth application. - Configure the application with the following details:
- Application name:
Gitpod
(or any other name you prefer) - Homepage URL: your Gitpod instance URL
- Authorization callback URL: the redirect URL copied from Gitpod
- Application name:
- Click
Register application
to create the OAuth app.
After registering, you will receive a Client ID
and a Client Secret
. Copy these values into the corresponding fields in Gitpod and hit Activate
to test the connection.
Connecting Your GitHub Enterprise Account
The first time every member of your organization starts a workspace from GitHub Enterprise, they will be prompted to connect their GHE account to their Gitpod account, via an authorization prompt.
The GHE OAuth window will appear, showing the name of the registered Gitpod OAuth app.
For private or internal repositories, users will be prompted to grant additional authorization before the workspace starts.
Starting Workspaces
To start a new workspace after logging into Gitpod, use or click on the New Workspace button in your Gitpod Dashboard. This will prompt for a repository URL, or suggest recent repositories opened with your account.
For an even more seamless experience with GitHub Enterprise, refer to our browser extension, which can add a convenient Gitpod button to every GitHub Enterprise page. —>
Granting additional GitHub Enterprise OAuth permissions
You can modify your GHE OAuth permissions to allow private repository access under User Settings
> Git Providers
using the context menu on the right.
You should see the connection to your GHE instance, with your GHE account ID, in your Gitpod integration settings.