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:
- Syncs the list of repositories you granted access to
- Syncs collaborators for each repository (to control access in the Dosu dashboard)
- Syncs labels for each repository (used for auto-labeling)
Note: The Dosu interface automatically refreshes to display repositories as they sync. Repositories will appear within a few moments after installation without requiring any manual refresh.
Repositories are not automatically added as data sources or deployments. To start using Dosu with a repository:
- Create a Data Source to index the repository's code, issues, and discussions
- Create a Deployment to enable Dosu to respond in that repository
For configuration options, see GitHub Configuration.
