Skip to main content
Installing the BrainGrid GitHub App requires specific permissions on your GitHub repository. This guide explains who can install the app and how to get the necessary permissions.

​
Permission Requirements

You must have Admin or Owner permissions to install the BrainGrid GitHub App on a repository.

​
Who Can Install GitHub Apps?

RoleCan Install?Limitations
Organization Owner✅ YesCan install on any repository in the organization
Repository Admin✅ Yes*Only on repos where they have admin rights, and only if the app doesn’t request org-level permissions
Personal Repo Owner✅ YesFull control over their personal repositories
Maintainer/Write/Triage/Read❌ NoCan request installation, but owner must approve
Important: Organization owners can restrict repository admins from installing GitHub Apps in their organization settings.

​
Installation Steps

1

Check Your Permissions

Before starting, verify you have the necessary permissions:
  1. Go to your repository on GitHub
  2. Click Settings (if you don’t see it, you don’t have admin access)
  3. Look for Collaborators & teams in the sidebar
If you can’t access Settings, you’ll need to request admin access first.
2

Start the Installation

Go to the Integrations section in the BrainGrid console.
Integrations
Or click Connect GitHub from your BrainGrid dashboard.
3

Select Installation Location

Choose where to install:
  • Personal account: Select your username
  • Organization: Select the organization (you must be an owner or admin)
If you’re not an owner/admin, you’ll see “Request” instead of “Install”
4

Choose Repository Access

Select which repositories BrainGrid can access:

All repositories

Grants access to all current and future repos

Only select repositories

Choose specific repositories from a list
We recommend selecting only the repositories you plan to use with BrainGrid
5

Review Permissions

Carefully review the permissions BrainGrid is requesting:
  • Read access to code and metadata
  • Write access to issues and pull requests
  • Read access to actions and workflows
These permissions allow BrainGrid to analyze your code and validate PRs.
6

Complete Installation

Click the installation button:
  • Install - If you have full permissions
  • Install & Request - If you have partial permissions
  • Request - If you need owner approval
If you see “Request”, the organization owner will receive a notification to approve your request

​
Getting Admin Access

If you don’t have the necessary permissions, here’s how to get them:

​
For Organization Repositories

If you’re an admin and need to grant access to someone:
1

Navigate to Repository Settings

  1. Go to the repository on GitHub
  2. Click Settings → Collaborators & teams
2

Add the User

  1. Click Add people or Add teams
  2. Search for the user by their GitHub username
  3. Select them from the dropdown
3

Set Admin Role

  1. In the role dropdown, select Admin
  2. Click Add [username] to [repository]
The user now has admin access and can install GitHub Apps.

​
For Personal Repositories

Personal repositories only have two roles: Owner (you) and Collaborators (write access only).Collaborators cannot have admin rights on personal repositories.
If you need multiple admins, consider:
  1. Transfer to an Organization: Move your repository to an organization where you can assign admin roles
  2. Create an Organization: Set up a new organization for your projects

​
Troubleshooting

You don’t have admin access to the repository. Contact the repository admin or owner.
Check if:
  • You selected at least one repository
  • Your organization has restrictions on GitHub App installations
  • You have a pending request waiting for approval
The organization owner may have concerns about:
  • The permissions requested
  • Organization policies
  • Security requirements
Discuss with them and share BrainGrid’s security documentation.
  • For personal repos: Look for Manage access instead
  • For org repos: You might not have admin permissions
  • Some organizations hide this based on policies

​
Quick Reference

​
Installation URL

https://github.com/apps/braingrid/installations/new

​
Required Permissions

  • Minimum: Repository Admin (with restrictions)
  • Recommended: Organization Owner (full control)

​
Can’t Install?

  1. Check your repository role
  2. Request admin access if needed
  3. Or ask an admin to install for you

​
Next Steps

Once you’ve successfully installed the BrainGrid GitHub App:

Continue with Quickstart

Return to the quickstart guide to analyze your repository

Learn More

Understand how BrainGrid works with your code

​
Additional Resources