# Connect GitHub (/docs/teams-and-billing/github)



Signing in with GitHub creates or opens your BerryBox account. **Installing the GitHub App is a separate authorization** that grants CI access to selected repositories.

1. Choose your BerryBox team and open GitHub setup.
2. Select **Connect GitHub** and complete the GitHub authorization.
3. Install the App in the intended GitHub organization, using an account allowed to authorize that organization.
4. Select the private repositories you want to use, then return to BerryBox.
5. Confirm the connection and enable your runner labels.

Use only repositories you are authorized to connect. Personal-account installations, public repositories and fork pull-request jobs are outside the current supported scope.

## Add or remove repositories [#add-or-remove-repositories]

Manage the App's repository selection in GitHub. BerryBox receives installation updates and uses the current connection for admission. Removing a repository or suspending/deleting the installation prevents new launches for that access.

If a repository is missing, confirm that the App is installed in the correct organization and that the repository was selected. Refresh the connection status in BerryBox before changing your workflow.

## Disconnect [#disconnect]

A permitted team administrator can disconnect the App from BerryBox. The server checks the current binding before making the change. Reconnect through the dashboard when ready; do not try to repair the connection by pasting GitHub tokens into an agent.

From the CLI, `berrybox github` reads installation status. `berrybox github-connect` provides the browser handoff information; it does not bypass GitHub authorization.