Setting up GitHub as a Source

👥
Access Required
Guru Access: You need to be an Admin, Source Creator, or relevant custom role to set up Sources
GitHub Access: To get started, users need to authorize via OAuth with GitHub and install the designated Guru GitHub App, which provides access to private repositories. This setup only needs to be completed once for all our GitHub integrations.

Setting up GitHub Repository as a Source

✍️
Note
If you're connecting to one of Guru's GitHub integrations for the first time, you'll need to authorize access via GitHub OAuth and install the designated Guru GitHub App to enable syncing with private repositories. Without this, only public repositories will be available to sync. To install the app:

Click Install/Configure Guru GitHub App.

From the list, select the organization you want to install the app to.

Select whether to allow access to all or selected repositories. If you choose Only select repositories, pick the specific repositories from the list.

Click Install.

Navigate to Manage > Sources.
Select GitHub Repository from the icon menu.
Select Configure Integration.
1. Optional: Rename the Source
Click Next.
Click Connect and log in to GitHub to authorize your account.
Pick the repository you'd like to pull information from. You'll see any public or private repositories you've allowed access to in the dropdown. Click Next.

✍️
Note
To select all repositories, a GitHub admin must establish the Guru connection, as non-admins will not be prompted with the "All repositories" button.

Select the branch and which file extensions to bring in. Use the asterisk (*) symbol for all file extensions. Select Finish.
Select which Groups you'd like to have access for this Source. Click Submit.

Objects synced from GitHub Repository

The GitHub Repository Source pulls all source code files from a specific branch.

Setting up GitHub Discussions as a Source

✍️
If you're connecting to one of Guru's GitHub integrations for the first time, you'll need to authorize access via GitHub OAuth and install the designated Guru GitHub App to enable syncing with private repositories. Without this, only public repositories will be available to sync. To install the app:

Click Install/Configure Guru GitHub App.

From the list, select the organization you want to install the app to.

Select whether to allow access to all or selected repositories. If you choose Only select repositories, pick the specific repositories from the list.

Click Install.

Navigate to Manage > Sources.
Select GitHub Discussions from the icon menu.
Select Configure Integration.
1. Optional: Rename the Source
Click Next.
Click Connect and log in to GitHub to authorize your account. Click Next.
Select your organization. Click Next.
Select the repository you want to pull discussions in from. You'll see any public or private repositories you've allowed access to in the dropdown. Select Finish.
Select which Groups you'd like to have access for this Source. Click Submit.

✍️
Note
To select all repositories, a GitHub admin must establish the Guru connection, as non-admins will not be prompted with the "All repositories" button.

Objects synced from GitHub Discussions

The GitHub Discussions Source pulls all discussion topics and their comments into Guru.

Setting up GitHub Issues as a Source

✍️
Note
If you're connecting to one of Guru's GitHub integrations for the first time, you'll need to authorize access via GitHub OAuth and install the designated Guru GitHub App to enable syncing with private repositories. Without this, only public repositories will be available to sync. To install the app:

Click Install/Configure Guru GitHub App.

From the list, select the organization you want to install the app to.

Select whether to allow access to all or selected repositories. If you choose Only select repositories, pick the specific repositories from the list.

Click Install.

Navigate to Manage > Sources.
Select GitHub Issues from the icon menu.
Select Configure Integration.
1. Optional: Rename the Source
Click Next.
Click Connect and log in to GitHub to authorize your account. Click Next.
Select the repository you'd like to pull issues in from. You'll see any public or private repositories you've allowed access to in the dropdown. Click Next.

✍️
Note
To select all repositories, a GitHub admin must establish the Guru connection, as non-admins will not be prompted with the "All repositories" button.

Choose how many days of historical data to include when checking for issues. By default, this is set to 90 days. Click Finish.
Select which Groups you'd like to have access for this Source. Click Submit.

Objects synced from GitHub Issues

The GitHub Issues Source pulls all issues and their comments into Guru

Setting up GitHub Wiki as a Source

✍️
Note
If you're connecting to one of Guru's GitHub integrations for the first time, you'll need to authorize access via GitHub OAuth and install the designated Guru GitHub App to enable syncing with private repositories. Without this, only public repositories will be available to sync. To install the app:

Click Install/Configure Guru GitHub App.

From the list, select the organization you want to install the app to.

Select whether to allow access to all or selected repositories. If you choose Only select repositories, pick the specific repositories from the list.

Click Install.

Navigate to Manage > Sources.
Select GitHub Wiki from the icon menu.
Select Configure Integration.
1. Optional: Rename the Source
Click Next.
Click Connect and log in to GitHub to authorize your account. Click Next.
Select the repository you want to pull the wiki from. You'll see any public or private repositories you've allowed access to in the dropdown. Click Finish.

✍️
Note
To select all repositories, a GitHub admin must establish the Guru connection, as non-admins will not be prompted with the "All repositories" button.

Select which Groups you'd like to have access for this Source. Click Submit.

Objects synced from GitHub Wiki

The GitHub Wiki Source pulls all markdown files from within a Github Wiki into Guru

Adding more repositories to an existing GitHub connection

These steps apply to all GitHub Sources: Repository, Discussions, Issues, and Wiki. How you add another repository depends on how you granted access when you first installed the Guru GitHub App:

All repositories. Add the new repository by following the setup steps for that Source above. No extra steps needed.
Only select repositories. GitHub requires you to revoke the Guru app's authorization before you can add a new repository. Follow the steps below.

Revoke and reauthorize the Guru GitHub App

In GitHub, go to Settings > Applications > Authorized GitHub Apps.
Find the Guru app and click Revoke.
In Guru, click Add Instance to connect the GitHub Source again. You'll be taken back to GitHub, where you can choose which repositories Guru can access.
Choose how to grant access:
- Select specific repositories. Pick the repositories you need, including any you connected previously. Reselecting them won't affect your existing Sources.
- Grant access to all repositories. Choose this option if you want to add repositories in the future without revoking access again. Only GitHub admins see this option.
Complete the setup in Guru to finish the configuration.

💡
Tip
If your team expects to connect more repositories over time, ask a GitHub admin to grant access to all repositories. This saves you from repeating these steps each time.

Permissions

When you connect Github as a source in Guru, you'll permission that content in Guru. Learn more here.
If someone is not provided with access in Guru to this source, they will not see Github results in searches or when chatting with Guru.