Skip to main content
Connect the GitHub App to bring selected repository details and recent push and pull request activity into Atlan. An organization administrator manages the connection. Repository data follows the access rules of the Atlan workspace it is connected to.

​
Before you begin

You need Atlan organization management permission, access to the GitHub account that can authorize the connection, and a GitHub App installation that includes the intended repositories. GitHub must be configured for your Atlan deployment.

​
Connect a repository

  1. Open the GitHub app from Atlan’s Store.
  2. Select Authorize GitHub account and finish authorization in GitHub. If the app is not installed, use Install GitHub App and choose the repositories the installation can access.
  3. Return to Atlan, select Refresh, choose the GitHub account installation, and connect it.
  4. Choose a Repository and an Atlan workspace, then select Connect repository.
  5. Select Sync now. Under Connected repositories, select the repository and inspect its synchronization status.
The repository becomes available in its selected workspace. If it is missing from the selector, check the GitHub App installation’s repository selection and refresh the connection.

​
What is imported

Atlan collects repository details, push freshness, and pull request lifecycle metadata. This connection does not collect source files, diffs, pull request bodies, commit messages, or email addresses. GitHub requires Contents: read permission for push activity; that permission also permits code reads even though this integration does not collect code. Use Sync skills from GitHub to publish skill bundles. That publishing workflow is separate from this repository metadata connection.

​
Connection problems

If the app reports that GitHub is not configured, ask your Atlan administrator to enable the connection. Reauthorize the GitHub account when authorization expires. A repository outside the selected GitHub App installation cannot be connected by choosing a different Atlan workspace.