Cloud Backups makes use of Restic to create and manage the backups for a site. One of the main features of Restic is that it creates incremental backups which mean that only files that have changed since the last backup are uploaded and saved to the cloud. As a result, less space is used on your cloud provider, and less time is wasted waiting for data to upload!
So why don’t all backup tools make use of incremental backups? The main drawback to Restic (and incremental backups in general) is that more work is required to view and restore individual backups.
Using Local’s Cloud Backups add-on is the easiest way to work with backups for your Local site, but if for some reason something, everything breaks and you can’t use Local, you can still manually access and restore the site backups using Restic.
This process is focused on manually restoring a backup from your cloud provider. Only follow the instructions below if you are unable to restore a site using the built-in restore process of the Local Cloud Backups add-on.
If you’re looking for more general information on using the Cloud Backups add-on, see this help doc.
We’ll go into more detail, but the general process for manually restoring a backup looks like:
Restic isn’t a Local-specific tool and is available for many different systems. You can install Restic by following the instructions for your specific system.
To verify you have everything installed, open a terminal and try running the
restic command. You should see more information about working with Restic!
If you haven’t used Restic before, it’s good to learn a few terms. Each individual backup is called a snapshot. All of the snapshots for a site are stored within a folder called a restic repo.
When using the Cloud Backups add-on, each site will create a new folder within the
LocalBackups folder of your Cloud Provider.
Each of these folders is a restic repo, and is named with a unique hash that looks something like
There’s no need to download the entire
LocalBackups folder, you only need to download the Restic repo for the site you want to restore. You’ll likely need to unzip this file someplace on your machine.
You can do most of these steps wherever you’d like on your computer. To make things easier to follow within this help doc, I recommend creating a folder named
manual-restore on your desktop to keep everything organized.
Within this folder, create a folder named
site where individual snapshots will be restored. Next, extract the Restic repo into a folder of its own. If you’re following these guidelines, your folder structure should look something like this:
~/Desktop/manual-restore/ ├ bec9b8c9-8149-462b-a175-471c4a5635ae <- The restic repo └ site <- Restored snapshots
One additional feature of Restic is that the Restic Repo is protected with a password. Your Local Account created this password for you when the cloud provider was connected. Navigate to the “Manual recovery password” setting on the “Cloud Backups” page of your Local Account.
With the Restic Repo downloaded and your password ready, you now have everything you need to view snapshots of the site as well as restore a specific ones.
Using the folder examples from above, open a terminal and navigate to the
From there, we can list the snapshots within the restic repo by running this command:
restic -r bec9b8c9-8149-462b-a175-471c4a5635ae snapshots
Restoring a snapshot is easy by using the snapshot id along with the
--target parameter for where you want the snapshot restored to. In this example, we use the
site folder we created earlier:
restic -r bec9b8c9-8149-462b-a175-471c4a5635ae restore --target site
After working through the above steps, you should have everything you need within the
site folder to restore your local site! The easiest way to import this snapshot into Local is to zip up the
site folder and drag-and-drop it onto Local. See this help doc for a visual walkthrough of that process!
It’s free and always will be.
Thanks! We'll contact you as soon as Local for Windows is available.
Next-level functionality and enhanced local development.
Sign up below and we’ll notify you the minute Local Pro is available for beta! Launching July 2019.
Thanks! We'll contact you as soon as the beta is available.
Local is only available as a desktop application, but no worries! Just enter your email in the box below and we'll send you a little reminder to download it via your desktop.
Thanks! Check your inbox for a link to download Local on your desktop.