Skip to content

Document GitHub Enterprise Apps and existing GitHub App setup - #2114

Merged
gabtorre merged 2 commits into
mainfrom
gt/github-app-registration-settings
Oct 30, 2026
Merged

gabtorre merged 2 commits into
mainfrom
gt/github-app-registration-settings

Conversation

@gabtorre

Copy link
Copy Markdown
Contributor

Add a "Using a GitHub Enterprise App" section for installing one private App across the organizations in a GitHub Enterprise Cloud enterprise. Sourcegraph's Create GitHub App flow can't register an App owned by an enterprise, so the App is created on GitHub and added to Sourcegraph.

Expand "Adding an existing GitHub App" into a full procedure: generate the private key and client secret, add the App, install it, add the auth provider, and create a code host connection. Add webhook setup, since Sourcegraph doesn't create an incoming webhook for an existing App.

Add a shared "GitHub App settings" table with the values Sourcegraph uses when it creates an App (URLs, permissions, install scope), and link to it from the create flow instead of repeating the permissions list.

Add a "Using a GitHub Enterprise App" section for installing one private
App across the organizations in a GitHub Enterprise Cloud enterprise.
Sourcegraph's Create GitHub App flow can't register an App owned by an
enterprise, so the App is created on GitHub and added to Sourcegraph.

Expand "Adding an existing GitHub App" into a full procedure: generate
the private key and client secret, add the App, install it, add the
auth provider, and create a code host connection. Add webhook setup,
since Sourcegraph doesn't create an incoming webhook for an existing
App.

Add a shared "GitHub App settings" table with the values Sourcegraph
uses when it creates an App (URLs, permissions, install scope), and link
to it from the create flow instead of repeating the permissions list.
@vercel

vercel Bot commented Oct 29, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
sourcegraph-docs Ready Ready Preview Oct 30, 2026 12:08am UTC

Request Review

@github-actions

github-actions Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Direct preview links to pages changed in this PR:

@github-actions

github-actions Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

@gabtorre gabtorre added the documentation Improvements or additions to documentation label Oct 29, 2026
@gabtorre
gabtorre requested a review from a team October 29, 2026 23:01
@gabtorre
gabtorre merged commit 4b49940 into main Oct 30, 2026
8 checks passed
@gabtorre
gabtorre deleted the gt/github-app-registration-settings branch October 30, 2026 00:09

This branch was successfully deployed

1 active deployment
Preview — 7093d2a5 Deployed Oct 30, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants