Skip to main content
The first step in setting up a Mjolnir run is connecting your GitHub account. This gives Mjolnir read access to your source code, the foundation of the whitebox approach.
Mjolnir only ever requests read access. It will never push code, open pull requests, or modify anything in your repositories.

​
How to connect

1

Start the connection

In the Mjolnir setup wizard, click Connect GitHub.
2

Authorise the app

You’ll be redirected to GitHub to authorise the Borg Security GitHub App.
3

Select your organisation

Choose the GitHub organisation or account that owns your repositories.
4

Grant repository access

Select the repositories you want to make available to Mjolnir.
5

Confirm

You’ll be redirected back to Odin. Your connected account will appear with a green checkmark.

​
Selecting repositories

After connecting, you’ll see a list of repositories from your connected GitHub organisation. Select all repositories that belong to your organisation.
Select broadly here. You can narrow down which repos are used for this specific run in Step 4: Code & Documentation. Selecting more repos now just makes them available as options later.

​
Already connected?

If you’ve previously connected GitHub (e.g. for another run), Odin will show your existing connection with the option to:
  • Continue with the current connection
  • Switch account to authenticate with a different GitHub account or organisation

​
Troubleshooting

GitHub App installations require explicit permission from a GitHub organisation owner. If you’re not an org owner, ask your GitHub admin to approve the Borg Security app installation at github.com/organizations/YOUR_ORG/settings/installations.
The GitHub App may have been installed with repository-scoped access rather than full org access. Go to your GitHub org settings > Installed GitHub Apps > Borg Security and update the repository access to All repositories (or add the specific ones you need).
Close the tab and try again from the Mjolnir wizard. If the issue persists, contact us at [email protected].

Next: Scope & Connectivity

Define the URLs Mjolnir will test