# Integrate GitHub with Databox

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 you've already established a connection, you can [reuse](/add-a-data-source) 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](/add-a-connection) 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.

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**.

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.

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.

 

Ask Genie
Get instant answers or help with your data using the in-app AI assistant.

Talk to an expert
For customers: Get help with your setup, strategy, or making the most of Databox.

Book a demo
New to Databox? See how it works and get guidance on getting started.

Send an email
Reach out to support for help with your account, data, or technical issues.