This guide walks you through the process of creating and configuring your own GitHub App for Matter AI, giving you complete control over permissions and data access.

​

Prerequisites

• GitHub organization or personal account with admin privileges

​

Step 1: Register a New GitHub App

1. Navigate to your GitHub organization settings (or personal settings)
2. Select Developer settings > GitHub Apps > New GitHub App
3. Configure the basic app settings:
   • GitHub App name: Choose a descriptive name (e.g., “YourCompany Matter AI”)
   • Homepage URL: Your company website or internal documentation URL
   • Callback URL: https://matter-backend.example.com/api/v1/auth/github/callback. Replace your domain later.
   • Webhook URL: https://matter-backend.example.com/github/webhook. Replace your domain later.
   • Webhook secret: Generate a secure random string to validate webhook payloads

​

Step 2: Set Required Permissions

Matter AI requires specific permissions to function properly. Configure the following permission settings:

​

Repository Permissions

​

Organization Permissions

​

Account Permissions

​

Subscribe to Events

Enable the following webhook events:

​

Step 3: Generate Private Key

1. After creating the app, scroll down to the “Private keys” section
2. Click Generate a private key
3. Save the downloaded .pem file securely

​

Step 4: Install the GitHub App

1. Navigate to your GitHub App’s settings page
2. Click on Install App in the sidebar
3. Choose the organization or account where you want to install the app
4. Select the repositories you want Matter AI to have access to
   • You can choose specific repositories or grant access to all repositories

​

Next Steps

Now that you’ve created your GitHub App, you can proceed to deploy Matter AI using one of our self-hosting options: