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

# GitHub

> Connect GitHub to sync repos, issues, and pull requests

Connect GitHub to Realm to make repository documentation, issues, pull requests, wikis, and discussions searchable. Navigate to **Settings** > **Data sources** and click **Connect** on GitHub, or click **Configure** if already connected.

## Connecting GitHub

Click **Connect** on the GitHub data source page. You'll be redirected to GitHub's OAuth flow. Review the permissions and click **Authorize**. The person connecting should be a GitHub organization admin.

If GitHub shows **Request** or **Install and request**, GitHub sends an installation request to the owners of the selected organization. Realm for GitHub remains disconnected and does not sync data while approval is pending. After an owner installs the app, return to Realm and connect GitHub again.

Once authorized, you can configure which repositories to sync from the GitHub app settings page. Click **Configure** on the data source page to manage repository access.

## What gets synced

| Content                                          | Synced |
| ------------------------------------------------ | ------ |
| Documentation files (Markdown, HTML, text, PDFs) | Yes    |
| Issues and issue comments                        | Yes    |
| Pull requests, reviews, and PR comments          | Yes    |
| Wikis                                            | Yes    |
| Discussions and replies                          | Yes    |
| Releases                                         | No     |
| Actions and workflows                            | No     |

## Permissions

Realm enforces GitHub's native permission model. Users can only see content from repositories they have access to in GitHub.

You can override this by switching to "Everyone in this organization" on the data source settings page, which makes all synced GitHub data visible to all Realm users.