Restore Wizard
The Restore Wizard guides you through restoring a backup snapshot to a new GitHub or Bitbucket repository in four steps.
Step 1: Select Target Account
Choose the GitHub organization, GitHub personal account, or Bitbucket account where the restored repository will be created.
- The dropdown lists every account with an active restore installation. Each entry shows the account name with a provider badge (GitHub or Bitbucket).
- If your target account is not listed, click Install for New Organization and pick a provider:
- GitHub: installs the GitSec Restore App on the organization or personal account you authorize.
- Bitbucket: connects your Bitbucket account through an authorization popup.
- GitLab is not yet available as a restore target.
The Restore App requires write access to create or push to repositories. This is a separate app from the Backup App used for read-only operations.
Step 2: Select Backup Source
Choose which backup snapshot to restore from.
- A dropdown shows the backup snapshots for the selected repository, loaded 10 at a time, scroll to the bottom of the list to load more.
- Each snapshot displays the repository full name, the execution ID, the completion timestamp, and a status badge (Completed, Failed, In Progress, Partially Completed, Pending, or Cancelled).
- Select the snapshot you want to restore.
Step 3: Configure Target Repository
Set up the target repository for the restore:
| Field | Description |
|---|---|
| Repository Type | Currently only New is available. Every restore creates a new repository. The Existing option is disabled and marked Coming Soon. |
| Workspace | Bitbucket targets only. Select the Bitbucket workspace where the new repository will be created. This field is required. |
| Repository Name | The name of the new repository (maximum 64 characters). The name must be unique in the target account or workspace. |
| Description | An optional description for the repository. |
| Visibility | Private or Public. For GitHub targets, Internal is also offered. |
| Included Items | Select which scopes to restore. |
:::caution Organization Required Internal visibility is a GitHub Enterprise feature available only for organization accounts. If the target account is a personal user account, please select Private or Public. If you choose Internal anyway, the wizard shows a warning and the repository is created as Private instead. :::
Included Items
Only source code (Code & Commits) can be restored today. Pull Requests, Issues, Wiki Pages, Projects, and Releases are shown disabled with Coming Soon badges. For Bitbucket targets, the Issues item is not shown at all.
Step 4: Review and Confirm
Review all restore details before starting:
- Source Details: The target account and the backup snapshot ID.
- Target Repository: Name, description, and visibility settings.
- Included Items: The scopes that will be restored, with checkmarks for enabled items.
Each section has an Edit button so you can go back and modify settings.
When ready, click Start Restore to begin the restore process.
After the Restore
Once the restore completes successfully, you will see a confirmation screen. The restored repository will be available in the target GitHub organization or Bitbucket workspace with the configured settings.
You can track restore progress on the Activity page or the Restores page in the sidebar.