Connecting GitHub
Connect your GitHub account to GitSec by installing the GitSec GitHub App. This grants GitSec read access to back up your repositories.
Install the GitHub App
- In the sidebar, navigate to Repositories > Add Provider.
- Click the GitHub card (GitLab is coming soon).
- You will be redirected to GitHub to authorize the GitSec app.
- Choose which organization or personal account to install the app on.
- Select All repositories or choose specific repositories to grant access to.
- Click Install to complete the authorization.
After installation, you will be redirected back to GitSec. Your connected repositories will appear under Repositories > GitHub.
Provider Installations
The Add Provider page also displays a Provider Installations table that shows all GitHub app installations associated with your account. Each installation shows:
- Provider — Github or Bitbucket
- Installation Target Name — The name of user/organization for the installation.
- Installed App — Redirection for the Git Provider
- Status — Whether the installation is active.
- Type — Whether the installation is user or organization.
What Permissions Does GitSec Need?
The GitSec Backup App requires read-only access to your repositories. It does not modify your code, branches, or settings.
| Permission | Level | Purpose |
|---|---|---|
| Repository contents | Read | Back up code and commits |
| Pull requests | Read | Back up pull request data |
| Issues | Read | Back up issue data |
| Metadata | Read | List and identify repositories |
The Restore App is a separate GitHub App that requires write access to create or push to repositories. It is only installed when you need to restore a backup. See Restore Overview for details.
Managing Connected Repositories
Once connected, go to Repositories > GitHub to see all your repositories. From there, you can include or exclude individual repositories from backups. See Managing Repositories for more information.
Next Steps
With GitHub connected, you're ready to create your first backup.