How to: Restore Github Backups

How to install the Restore app


The Rewind Backups for GitHub (BackHub) restore app must be installed before you can restore a backup. This is a cloud installation and does not require any installation on your local machine.


For restoring a backup, write permission to at least one repository is necessary. The Rewind Backups for GitHub (BackHub) restore app is installed separately so that you can remove the app and its permissions after the restore has been completed.

There are two ways to install the Rewind Backups for GitHub (BackHub) Restore app. 

Option 1: Installing from the Rewind Backups for GitHub app (BackHub)

  1. Sign-in to your Rewind Backups for GitHub (BackHub) account 
  2. Choose on any backup and any date and click restore (You don’t have to choose the repository you want to restore at this time.)

  1. Click ”Start installation” button. 

  1. Click install giving access to all repositories (Optional: You can also choose a random repository after choosing “Only select repositories” option.)

Option 2. Installing the restore app from the directory

  1. Go to the GitHub App directory and click configure

  1. Select the account you’d like to install the Restore app for 


  1. Click install giving access to all repositories (Optional: You can also choose a random repository after choosing “Only select repositories” option.)



How to restore a backup snapshot to GitHub

If you have not installed the Restore app yet, please install it first. After installing the restore app, you can follow these steps to restore any backup.

  1. Choose the repository and the date

In Rewind Backups for GitHub app (BackHub) , click on the repository you’d like to restore and choose a date you’d like to restore to. Then click Restore.

  1. Give a name to your new repository and click Restore. (Your recovered repository will have this name on your GitHub account.)


  1. Open your GitHub account and check the restored repository. It may take a couple of minutes up to an hour for the restore to complete, depending on the size of your repository.

Note: Do not change anything in the repository while the restore is in progress (for example, don't create an issue or try to commit).

What can be restored?

You can restore everything that is included in the backup. However, due to limitations of the GitHub API, some data either cannot be restored directly or else it comes in a different format for practical reasons:

  • Wikis cannot be restored directly back to GitHub. See these instructions if you want to restore a wiki.
  • Pull requests can only be restored as issues.
  • When restoring, all issues are filed by the user and have the current date stamp. The original author and issue date are included as text in the issue description.
  • We do not link @mentions in issues or comments. This prevents flooding the participating users with notification emails.
  • We do not assign issues when restoring in order to avoid email notifications. The information about the original assignee displays in the issue description.

How to uninstall the BackHub restore app

Remove the Restore app (Optional)

After the restore has been completed, you can remove the BackHub Restore app and its permissions if you’d like to. This improves the security on your account revoking write access of Rewind Backups for GitHub (BackHub) application .

  1. Open the app settings at GitHub .
  2. Select the organization from which to remove the app.
  3. Uninstall the “BackHub Restore” app from your account.