Managing Repositories
The Repositories > GitHub, Repositories > GitLab, and Repositories > Bitbucket pages list all repositories accessible through your connected accounts. Each Self-Managed GitLab instance you connect appears as its own entry under Repositories.
Syncing with Your Provider
GitSec keeps your repository list in sync automatically, but you can also refresh it on demand. Click the sync (refresh) button in the page header to pull the latest repositories from your Git provider. For example, right after creating a new repository on GitHub, GitLab, or Bitbucket.
For GitLab, new projects are also picked up automatically by an hourly sync. After you connect GitLab, the first sync runs about 15 minutes later.
When the sync finishes, a notification reports the result, such as 3 repositories added, 5 updated. If nothing changed, it reports No changes found.
Searching and Filtering
Use the search box above the list to find repositories by name. Results update as you type, no need to press Enter.
Next to the search box, three filter groups let you narrow the list:
| Filter | Options | Description |
|---|---|---|
| Visibility | Private, Public, Internal | Filter by the repository's visibility on the provider. |
| Status | Active, Inactive | Filter by whether the repository is active for backups. |
| Archive | Archived, Not Archived | Filter by the repository's archived flag on the provider. |
Search and filter selections are reflected in the page URL, so you can bookmark a filtered view or share it with a teammate.
List and Grid Views
On desktop, a toggle above the list switches between two views:
- List: A table with detailed columns and bulk selection checkboxes.
- Grid: Cards showing each repository's name, description, visibility, and actions.
Your choice is remembered for 7 days. On mobile devices, the list view is always used.
Repository List
In the list view, the table shows the following columns:
| Column | Description |
|---|---|
| Full Name | The owner and repository name (e.g., org/repo-name). Click it to open the repository detail page, and hover over any warning icon next to it to see why a repository is inaccessible. |
| Description | The repository description from GitHub, GitLab, or Bitbucket. |
| Default Branch | The primary branch (e.g., main, master). |
| Visibility | Whether the repository is Private, Public, or Internal. |
| Connected | The date the repository was connected to GitSec. |
| Archived Status | Whether the repository is Archived or Not Archived. |
| State | A toggle showing whether the repository is Active or Inactive for backups. |
| Schedulers | The repository's backup schedulers as active / total. The count is shown in amber when all of its schedulers are paused, and a plus icon is shown when the repository has no scheduler. |
The list also shows which repositories back up on every push. Where push events are not supported for a repository, the indicator shows Push event not available. See Push Event Backups.
At the end of each row (and on each card in grid view) you will find two actions:
- Open on provider: The arrow icon opens the repository on GitHub, GitLab, or Bitbucket in a new tab.
- Backup now: Starts an on-demand backup of the repository (see below).
Activating and Deactivating Repositories
When repositories are first synced from GitHub, GitLab, or Bitbucket, they are Inactive by default. You need to manually activate the repositories you want to protect:
- Inactive: The default state. The repository is not eligible for automated backups.
- Active: The repository is eligible for scheduled, on-demand, and push-event backups.
To change a single repository's state, use the toggle in the State column. Archived repositories cannot be activated.
Each active repository consumes one repository slot from your plan's quota. If activating a repository would exceed the remaining quota, the change is rejected. Deactivate other repositories or upgrade your plan first. Deactivating a repository frees its slot.
Deactivating, on the other hand, is never blocked: even when you are over your plan's limit (for example, after a downgrade), you can always deactivate repositories to get back under the quota.
Deactivating a repository also disables its backup schedulers, and a scheduler cannot be enabled while its repository is inactive. When you activate the repository again, its schedulers stay disabled, re-enable them manually from the Schedulers page or the repository's Scheduler tab. Backups never resume on their own after a repository is reactivated.
Bulk Activate and Deactivate
To change many repositories at once, use bulk selection, available in the List (table) view only:
- Tick the checkboxes of the repositories you want to change. The checkbox in the header row selects every repository on the current page. Archived repositories cannot be selected.
- A toolbar appears showing the number of selected repositories.
- Click Activate selected to activate them for backup immediately, or Deactivate selected to deactivate them.
- Deactivating asks for confirmation first, because the selected repositories will no longer receive scheduled or on-demand backups.
Bulk activation is subject to the same quota check as single activation: if the selection would exceed your plan's remaining repository quota, the operation is rejected.
Backing Up a Repository On Demand
Click Backup now on any row or card to start a backup right away, without waiting for a scheduler. A dialog opens where you select which scopes to include. The scopes offered depend on the provider:
| Scope | GitHub | GitLab | Bitbucket |
|---|---|---|---|
| Repository Metadata | ✓ | ✓ | ✓ |
| Code & Commits (always included) | ✓ | ✓ | ✓ |
| Pull Requests (GitLab: Merge Requests) | ✓ | ✓ | ✓ |
| Merge Request Comments | ✓ | ||
| Issues | ✓ | ✓ | |
| Releases | ✓ | ✓ | |
| Collaborators | ✓ | ✓ |
Click Start Backup to queue the backup. You can follow its progress in the Background jobs panel at the bottom right of the screen, or on the repository's Activity tab.
Backup now is disabled with a tooltip explaining why. For repositories that are archived, inactive, or no longer accessible (for example, when the repository was deleted on the provider or GitSec's access was revoked).
See Creating Backups for more on backup types and scopes.
Pagination
If you have many repositories, the list is paginated. Use the pagination controls at the bottom to navigate between pages and change the page size.
Opening a Repository
Click a repository's name to open the Repository Detail page, where you can view backups, configure schedulers, manage push events, and more.