Restore Wizard
The Restore Wizard guides you through restoring a backup snapshot to a GitHub repository in four steps.
Step 1: Select Target Organization
Choose the GitHub organization or personal account where the restored repository will be created.
- A list of available organizations is displayed.
- If the GitSec Restore App is not yet installed on an organization, click Install for New Organization to authorize it.
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 all available backup snapshots for the selected repository.
- Each snapshot displays its ID, timestamp, and status.
- Select the snapshot you want to restore.
Step 3: Configure Target Repository
Set up the target repository for the restore:
| Field | Description |
|---|---|
| Repository Type | Create a New repository or restore to an Existing one. |
| Repository Name | The name for the new or existing repository. |
| Description | An optional description for the repository. |
| Visibility | Private, Public, or Internal. |
| Included Items | Select which scopes to restore (currently Code & Commits). |
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.
Step 4: Review and Confirm
Review all restore details before starting:
- Source Details — The organization and 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 on GitHub in the target organization with the configured settings.
You can track restore progress on the Activity page or the Restores page in the sidebar.