Viewing Backups

You can view backup snapshots at both the global and repository level.

Backup Snapshots Page

Navigate to Backup Snapshots in the sidebar to see all backup snapshots across all repositories. The table includes:

Column	Description
Name	The name you gave the backup. A backup without a name shows its finish time instead.
Repository	The repository that was backed up.
Date	When the backup was taken.
Size	Snapshot size.

The list is paginated for large numbers of backups. Use the page controls at the bottom to navigate.

Backup Statuses

Each backup execution is in one of seven statuses:

Status	Meaning
Pending	The backup job is queued and waiting to start.
In Progress	The backup is currently running.
Completed	All selected scopes were backed up without errors.
Partially Completed	The backup finished, but not all selected scopes could be backed up successfully. See the Activity page for which steps failed and why.
Failed	The backup encountered an error and did not complete. Hover over the status badge or expand the row on the Activity page to see the failure reason.
Cancelled	The backup was cancelled before it finished.
Paused	The backup is temporarily paused.

Running backups can also be followed step by step in the Background jobs panel at the bottom right of every page.

Searching and Filtering

• Search by name: Type in the Search by name box to find backups by the name you gave them.
• Pinned only: Turn on Pinned only to list pinned backups only.
• Date range: Pick a start and end date on the calendar to show backups taken in that period.

Rename and Pin a Backup

• Rename: Use Rename to give a backup your own name, for example the release it was taken before. The name makes the backup easier to find with Search by name.
• Pin and unpin: Use Pin this backup to keep an important backup in view, and Unpin this backup to remove the pin. Pinned backups can be listed with the Pinned only filter.

Renaming or pinning a backup does not change the backed-up data.

Delete a Backup

To delete a single backup:

1. Open More actions on the backup's row.
2. Select Delete.
3. To confirm, type the repository's full name exactly as shown in the dialog, in owner/repository form.

When a backup is deleted:

• Its data is removed from every storage provider it was stored in, and the storage space it used is freed.
• The run that created it stays in Activity, marked as Deleted.

warning

Deleting a backup cannot be undone. A pinned backup cannot be deleted. Unpin it first, then delete it.

Per-Repository Backups

To view backups for a specific repository:

1. Go to Repositories > GitHub, Repositories > GitLab, or Repositories > Bitbucket.
2. Click on a repository.
3. Open the Backups tab.

This shows the backups of that single repository.

Restoring from a Backup

Each backup row includes a Restore button. Click it to open the Restore Wizard for that repository with the snapshot pre-selected as the source.

Backup Details

Each backup snapshot contains:

• Snapshot ID: A unique identifier for the backup.
• Scopes: The data included in the backup.
• Storage: Icons indicating which storages stored the backup snapshot (GitSec Storage & BYOS).
• Trigger: How the backup was initiated (On Demand, Scheduled, or Push Event).
• Timestamps: Start and finish times.
• Size: Total storage consumed.