> ## Documentation Index
> Fetch the complete documentation index at: https://ona.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Enterprise Server

Gitpod works well with public, private, or internal repositories from your own instance of [GitHub Enterprise](https://docs.github.com/en/enterprise-server@3.15/get-started/onboarding/getting-started-with-github-enterprise-server) (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:

1. Navigate to the Organization settings using the organization dropdown in the top left corner.
2. Select `Git Providers` and click `New Git Provider`.
3. Choose `GitHub` as the provider type and enter your GHE hostname.
4. 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:

1. Open your GitHub Enterprise Developer settings.
2. Go to `OAuth Apps` and create a new OAuth application.
3. 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
4. Click `Register application` to create the OAuth app.

<Frame caption="GitHub Enterprise register new OAuth application form">
  <img src="https://mintcdn.com/gitpod-13c83c2b/e8LRoo3UknjjGZet/images/integrations/github-new-oauth-application.png?fit=max&auto=format&n=e8LRoo3UknjjGZet&q=85&s=8aa31163d31fb6887f8e85e53e354c45" width="850" height="720" data-path="images/integrations/github-new-oauth-application.png" />
</Frame>

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.

<Frame caption="Prompt to authorize with GitHub Enterprise">
  <img src="https://mintcdn.com/gitpod-13c83c2b/e8LRoo3UknjjGZet/images/integrations/github-enterprise-auth-prompt.webp?fit=max&auto=format&n=e8LRoo3UknjjGZet&q=85&s=8a946746680c7e6d126c5c79b07d1a0c" width="1336" height="1164" data-path="images/integrations/github-enterprise-auth-prompt.webp" />
</Frame>

The GHE OAuth window will appear, showing the name of the registered Gitpod OAuth app.

<Frame caption="OAuth confirmation from GitHub Enterprise">
  <img src="https://mintcdn.com/gitpod-13c83c2b/e8LRoo3UknjjGZet/images/integrations/github-enterprise-oauth-popup.png?fit=max&auto=format&n=e8LRoo3UknjjGZet&q=85&s=350b3419d9252bcfdb773a38038861c8" width="850" height="490" data-path="images/integrations/github-enterprise-oauth-popup.png" />
</Frame>

For private or internal repositories, users will be prompted to grant additional authorization before the workspace starts.

<Frame caption="Private repo OAuth authorization from GitHub Enterprise">
  <img src="https://mintcdn.com/gitpod-13c83c2b/e8LRoo3UknjjGZet/images/integrations/github-enterprise-private-repo-scope-authorization.webp?fit=max&auto=format&n=e8LRoo3UknjjGZet&q=85&s=9fa0e2e518715d86851f469941547bb5" width="1752" height="1200" data-path="images/integrations/github-enterprise-private-repo-scope-authorization.webp" />
</Frame>

## Starting Workspaces

To start a new workspace after logging into Gitpod, use `Ctrl/Cmd + O` 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.

<Frame caption="Open in Gitpod form">
  <img src="https://mintcdn.com/gitpod-13c83c2b/e8LRoo3UknjjGZet/images/integrations/ghe-open-in-gitpod.webp?fit=max&auto=format&n=e8LRoo3UknjjGZet&q=85&s=3e66706dd0fbb2eda642ae9d2ec04660" width="1756" height="1140" data-path="images/integrations/ghe-open-in-gitpod.webp" />
</Frame>

For an even more seamless experience with GitHub Enterprise, refer to our [browser extension](/classic/user/configure/user-settings/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.

<Frame caption="Gitpod settings for GitHub integration permissions">
  <img src="https://mintcdn.com/gitpod-13c83c2b/e8LRoo3UknjjGZet/images/integrations/github-oauth-scopes.webp?fit=max&auto=format&n=e8LRoo3UknjjGZet&q=85&s=8a068feef5ea7087454a98185e98cc15" width="1122" height="1206" data-path="images/integrations/github-oauth-scopes.webp" />
</Frame>

You should see the connection to your GHE instance, with your GHE account ID, in your Gitpod integration settings.

<Frame caption="GitHub Enterprise connection in Gitpod integration settings">
  <img src="https://mintcdn.com/gitpod-13c83c2b/e8LRoo3UknjjGZet/images/integrations/github-enterprise-connection.png?fit=max&auto=format&n=e8LRoo3UknjjGZet&q=85&s=5198c3b6769638536f5efe37d11994e2" width="850" height="406" data-path="images/integrations/github-enterprise-connection.png" />
</Frame>
