Skip to content

Integrate GitHub with Databox


Availability

userUsers, Editors, and Admins
accountAll accounts

GitHub is a cloud-based platform for version control and software collaboration, used by development teams to host repositories, manage code changes through pull requests, and track work with issues and project boards. Connecting GitHub to Databox brings your repository activity data into dashboards alongside your other business and engineering metrics, so you can monitor development velocity, track open issues and pull request resolution time, and share progress reports with stakeholders in one place.

Connection

Before you begin

If your credentials don't include full access to the data source, make sure your access level meets any permission requirements listed in the Specification section of the integration's page in the Metric Library.

If you've already established a connection, you can reuse it to add new repositories, as long as those repositories are accessible with the existing connection's credentials.

Step 1: Sign in with GitHub

To connect GitHub to your Databox account for the first time or with new credentials, log in using your username or email address, Google account, Apple ID, or a passkey.

github-sign-in-screen

Step 2: Select the repository

After authorization, select the GitHub repository you want to report on. Each repository is connected as a separate data source in Databox, so repeat the process to connect additional repositories.

Resources

For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below.

FAQ

Does Databox make any changes to my GitHub repositories or code?

No. Databox requests read-only access to your GitHub repository data. No changes are made to your code, issues, pull requests, or repository settings. You can revoke access at any time from your GitHub account under Settings > Applications > Authorized OAuth Apps.

My GitHub account belongs to an organization. Do I need approval to connect?

If your organization has OAuth app access restrictions enabled, connecting Databox may require approval from your organization owner. You can request approval from the Authorized OAuth Apps tab in your GitHub account settings. Once the organization owner approves the app, the connection will have access to that organization's repositories.

Why does Databox require a GitHub sign-in instead of a personal access token?

The GitHub integration uses OAuth 2.0 for authorization. This means Databox connects through your GitHub account rather than a manually generated token. The OAuth flow grants Databox a scoped, revocable token that limits access to repository data only.