1 – GitHub Installation

To use a GitHub repository as a data source or create a deployment for it, you need to install the Dosu GitHub App.

Installing the App

Click here to install the Dosu GitHub App.

During installation, you can choose to grant Dosu access to all repositories in your account or organization, or to specific repositories.

Permissions

The Dosu GitHub App requests the following permissions:

Read access:

• Repository contents, metadata, and administration
• Actions, checks, and commit statuses

Read and write access:

• Issues and issue comments
• Pull requests and pull request reviews
• Discussions and discussion comments

These permissions allow Dosu to read your code and conversations, respond to issues and discussions, and apply labels to issues and pull requests.

What Happens After Installation

After you install the app, Dosu automatically:

1. Syncs the list of repositories you granted access to
2. Syncs collaborators for each repository (to control access in the Dosu dashboard)
3. Syncs labels for each repository (used for auto-labeling)

Repositories are not automatically added as data sources or deployments. To start using Dosu with a repository:

1. Create a Data Source to index the repository's code, issues, and discussions
2. Create a Deployment to enable Dosu to respond in that repository

For configuration options, see GitHub Configuration.