Skip to main content
Free plan: public repositories only. Dev plan or higher: private repositories. View plans →
Signed up with email and password? Verify your email address before connecting GitHub — the button is disabled until your address is confirmed. Check your inbox for the verification email or resend it from Settings → Account. GitHub OAuth sign-ups are verified automatically.

​
Install the GitHub App

1

Open the connect flow

Go to Dashboard → Repositories and click Connect GitHub.
2

Choose account and repositories

On the GitHub App installation page, select the account or organisation that owns your repositories. Under Repository access, choose Only select repositories and tick the repositories you want to connect.
3

Complete installation

Click Install & Authorize.Repositories appear in the BattleTest Repositories list with a Connected status. PR reviews begin immediately on the next pull request event.

​
Add or remove repositories from an existing installation

1

Open repository settings

Go to Dashboard → Repositories.
2

Configure the App

Click Configure GitHub App.
3

Update access

Under Repository access, add or remove repositories, then click Save.

​
Connect repositories in a GitHub organisation

To install on an organisation you must have organisation Owner permissions, or the organisation must allow members to install Apps. If the install button is greyed out, ask an organisation owner to complete the installation. To install on all current and future repositories in an organisation, select All repositories on the installation page instead of selecting specific repositories.

​
Uninstall the GitHub App

Uninstall from GitHub: Settings → Applications → Installed GitHub Apps → BattleTest Security → Configure → Uninstall. BattleTest loses repository access immediately. Historical findings are retained in your account until you delete them.