Setting up GitHub as a source

👥

Access Required

Guru Access: You need to be an Admin in Guru 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

1. Navigate to Manage > Sources.
2. Select GitHub Repository from the icon menu.
3. Select Configure Integration.
   1. Optional: Rename the Source
4. Click Next.

✍️

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:

1. Click Install/Configure Guru GitHub App.
2. From the list, select the organization you want to install the app to.
3. Select whether to allow access to all or selected repositories. If you choose Only select repositories, pick the specific repositories from the list.
4. Click Install.

7. Click Connect and log in to GitHub to authorize your account.
8. 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.
9. Select the branch and which file extensions to bring in. Use the asterisk (*) symbol for all file extensions. Select Finish.
10. 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

1. Navigate to Manage > Sources.
2. Select GitHub Discussions from the icon menu.
3. Select Configure Integration.
   1. Optional: Rename the Source
4. Click Next.

✍️

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:

1. Click Install/Configure Guru GitHub App.
2. From the list, select the organization you want to install the app to.
3. Select whether to allow access to all or selected repositories. If you choose Only select repositories, pick the specific repositories from the list.
4. Click Install.

5. Click Connect and log in to GitHub to authorize your account. Click Next.
6. Select your organization. Click Next.
7. 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.
8. Select which Groups you'd like to have access for this Source. Click Submit.

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

1. Navigate to Manage > Sources.
2. Select GitHub Issues from the icon menu.
3. Select Configure Integration.
   1. Optional: Rename the Source
4. Click Next.

✍️

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:

1. Click Install/Configure Guru GitHub App.
2. From the list, select the organization you want to install the app to.
3. Select whether to allow access to all or selected repositories. If you choose Only select repositories, pick the specific repositories from the list.
4. Click Install.

5. Click Connect and log in to GitHub to authorize your account. Click Next.
6. 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.
7. Choose how many days of historical data to include when checking for issues. By default, this is set to 90 days. Click Finish.
8. 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

1. Navigate to Manage > Sources.
2. Select GitHub Wiki from the icon menu.
3. Select Configure Integration.
   1. Optional: Rename the Source
4. Click Next.

✍️

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:

1. Click Install/Configure Guru GitHub App.
2. From the list, select the organization you want to install the app to.
3. Select whether to allow access to all or selected repositories. If you choose Only select repositories, pick the specific repositories from the list.
4. Click Install.

5. Click Connect and log in to GitHub to authorize your account. Click Next.
6. 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.
7. 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