> ## Documentation Index
> Fetch the complete documentation index at: https://specterops-fetch-json-component.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure a GitHub App Installation

> Set up a GitHub App for GitHound data collection with higher rate limits.

<img noZoom src="https://mintcdn.com/specterops-fetch-json-component/pkiaFEhjWYPnhxMb/assets/enterprise-AND-community-edition-pill-tag.svg?fit=max&auto=format&n=pkiaFEhjWYPnhxMb&q=85&s=c83d7e4a67c741a979c0e77bf15c1252" alt="Applies to BloodHound Enterprise and CE" width="482" height="45" data-path="assets/enterprise-AND-community-edition-pill-tag.svg" />

GitHub App installations provide a higher API rate limit of **15,000 requests per hour** compared to **5,000** for Personal Access Tokens(PATs).

<Note>This is the recommended authentication method for organizations with 500+ repositories.</Note>

## Install a GitHub App

Follow the steps below to create and configure your own GitHub App.

1. Navigate to your **Organization Settings** > **Developer settings** > **GitHub Apps**.
2. Click **New GitHub App**.
3. Configure the app:
   * **GitHub App name**: Choose a unique name (e.g., `YourOrg-GitHound`)
   * **Homepage URL**: Your organization's URL
   * **Webhook**: Uncheck "Active" (not needed for collection)
4. Set all required [repository and organization permissions](/opengraph/extensions/githound/collect-data#required-permissions) to **Read-only**.
5. Under "Where can this GitHub App be installed?", select **Only on this account**.
6. Click **Create GitHub App**.
7. Scroll down and click **Generate a private key** - save the downloaded `.pem` file securely.
8. Note the **App ID** and **Client ID** displayed on the app settings page.
9. Click **Install App** in the left sidebar to install the app to your organization.

## Get the Installation Details

1. Navigate to your **Organization Settings** > **Third-party Access** > **GitHub Apps**.
2. Find the app you just created and click **Configure**.
3. The numeric value in the URL is the **App Installation ID**.
4. Click **App settings** to access the **Client ID** and **App ID**.

## Security Considerations

* Store the `.pem` private key securely and never commit it to version control.
* Rotate keys periodically and revoke old ones.
* Only install the app on organizations that require collection.
* Periodically verify the app has only the minimum required permissions.

## Next Steps

After installing and configuring the GitHub App, proceed to [Running the Collector](/opengraph/extensions/githound/collect-data) to start collection.