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 and Bitbucket are 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:
- Installation ID — The unique identifier for the installation.
- Account — The GitHub user or organization.
- Status — Whether the installation is active.
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.