GitHub Setup Guide

GitHub Setup Guide

Prerequisites

• An active GitHub account with permission to create Personal Access Tokens for the organization and repositories you want to sync.

Note: GitHub enforces a rate limit of 5,000 requests/hour per account, not per token - all personal access tokens from the same GitHub account share one quota, so generating several tokens on the same account will not raise the limit. If you're syncing a large organization (many repositories or a high commit volume), add tokens from multiple different GitHub accounts in Matia - see Step 2 below.

Setup Guide

Step 1: Obtain a GitHub Personal Access Token

1. Sign in to GitHub.
2. Click your profile photo in the top-right corner, then click Settings.
3. In the left sidebar, click Developer settings.
4. Click Personal access tokens → Tokens (classic).
5. Click Generate new token → Generate new token (classic).
6. Enter a descriptive Note, e.g. Matia Integration.
7. Set an Expiration for the token.
8. Under Select scopes, check repo and read:org.
9. Click Generate token.
10. Copy the generated token now - GitHub will not show it again.

Tip: To avoid rate limiting on large syncs, repeat Step 1 to generate additional tokens - ideally from 4-5 different GitHub accounts with access to the organization - and add all of them in Matia in Step 2. Matia will rotate across the provided tokens automatically.

Step 2: Complete Configuration in Matia

1. Under Access Tokens, click + Add and enter the token you generated. Click + Add again to enter additional tokens, if you generated more than one.
2. Enter the Organization name.
3. Enter an Asset Name.
4. (Optional) Enter a Description.
5. (Optional) Assign Tags.
6. Select an Owner.
7. Verify that your GitHub account is successfully connected by clicking on Test Connection.
8. Click Connect.