V2 Backups Part 1. How Backups Work / Configuration / Purging / Exports and Imports

13 min read

Currently the new backup system is BETA only. 

Please do not rely on Beta Backups V2 for your production websites. By running these backups you are agreeing to also maintain separate comprehensive third-party backups of all sites with Backups V2 enabled.

Any ticket submitted for a website with a Backups v2 issue will be treated primarily as a bug report and there is no critical/urgent support or support guarantees.

Activating V2 Backups

To activate backups 2.0 head to your Servers page and click on the name of the server you wish to activate it on.

Warning: This will disable Borg and purge all existing Borg backups from your system. You are responsible for ensuring you have existing backups in place. By enabling Backups v2 you accept full responsibility for this action and confirm you have alternative backups in place. Only enable if you agree to these conditions. Once enabled, this can not be disabled. Borg is going back to the Delta Quadrant.


Our new V2 backups system offers multiple significant improvements over our original V1 system. This is part 1 of 3 of our V2 documentation, and in this article, we’ll look at how you can configure and manage your backups using the new V2 system, and answer all of the common questions we’re asked about how things work and where things are stored.

In part 2 we’ll look at how to get started with local backups, and in part 3 we’ll look at setting up your remote backups.

Table of Contents

  1. How GridPane backups work
  2. Where local backups are stored
  3. Local backups storage threshold
  4. Default backup retention time
  5. Adjusting the backup retention time
  6. Purging backups
  7. Exporting backups for SFTP download
  8. Restoring exported backups
  9. Setting the daily pruning time
  10. Setting backup concurrency

V2 backups run on a custom implementation of the exceptional Duplicacy, a cross-platform cloud backup solution. On its own, without any of the configurations our team has created for its WordPress implementation and integration into GridPane, the software would cost you $50/year per server.

Improvements over the older V1 system that runs on Borg include: –

  1. Lock-Free Deduplication (which has numerous benefits).
  2. Remote backups to 4 different external providers: AWS S3, Backblaze B2, Dropbox, and Wasabi.
  3. Significant performance improvement.
  4. Exporting previous, existing backups for download over SFTP.

We’ll dig into this and more below. To jump straight into setting up V2 backups for your websites, please see the following 2 articles for local and remote backups:

How GridPane Backups Work

Both our V1 and V2 backup systems use incremental backups. This means that each time your websites are backed up, the data is de-duplicated and compressed. After the first initial full backup, each backup builds upon the previous data.

Duplicacy uses deduplication, which stores chunks to your local server and/or cloud storage using content hashes as file names. During backup creation, it compares them to existing chunks and shares identical chunks between backups.

When a backup is to be restored, the system collects all the data chunks relevant to that specific backup and reconstitutes it.

A common question we get asked is “where is my site backup stored?” with the expectation that they will be accessible in a zip file somewhere on the server. As backups are all stored as chunks, this format that is non-human readable and so they don’t exist in the same way that a plugin backup, for example, would exist on your server.

Duplicacy Chunks

With Duplicacy:

  • Chunks are each saved to their own individual file with their own hash which functions as the file name.
  • Chunks require no further modification once saved (and thus data corruption is far less likely to occur due to their immutability).
  • Chunks of data that are the same across multiple websites only need to be stored once.

Duplicacy Lock-Free Deduplication

Duplicacy also uses what’s called “Lock-Free Deduplication”, which means it doesn’t require a centralized indexing database for keeping track of backup data. Instead, it performs a much simpler file lookup by using file names derived from the hash of each chunk. This method does not require a distributed locking mechanism on top of the file storage.

Lock-Free Deduplication both reduces code complexity and makes deduplication less prone to errors, and Duplicacy has been shown to offer significant performance improvement for backups over other well-known backup tools.

In a nutshell, what all this means is that Duplicacy is an extremely efficient, reliable, and customizable backup solution, and GridPane’s implementation makes it one of the most comprehensive WordPress backup systems available.

Why use incremental backups?

Incremental backups are less resource-intensive, and they require significantly less disk space than full, individual website backups.

Taking full website backups of a site every hour as a separate archive, even if it was compressed, would use so much space that it wouldn’t be suitable locally, even for small websites. For large websites, you may only be able to take 1 or 2 backups before the server no longer has space to create a third.

By backing up incrementally, after your first initial backup which copies your entire website, all future backups are much, much smaller, only taking into account the changes. This allows you to take [potentially] hundreds of backups while saving you a tremendous amount of disk space.

Where Local Backups are Stored

Our backups system stores backup data and data related to backups in multiple places on your server. Below details each of these locations and what they store.

1. The Backup Storage Location on the Server

Local backups are stored in /opt/gridpane/backups/duplications, which, as mentioned in the previous section, has a structure that isn’t human-readable. Here you will not see individual backups of your websites, or your WordPress files or database. 

2. The Backup Cache folder

Located inside your websites htdocs directory is a cache for your website’s previous changes. This cache helps speed up the backup process so the system can easily see and check only the changed files and backs up these changes.

3. SFTP Exports

When you click on the export backup button in the UI (or run the GP-CLI manually), the backup program reconstitutes the backup you’ve specified and stores it in the /root directory on your server for 4 hours. You can download it over SFTP during this time, and then automatically removes it after 4 hours have passed.

Local Backups Storage Threshold

This is the threshold of the available free disk space required in order for a scheduled backup to proceed. If the available disk space on your server less than this amount, your website backups will be paused.

You can adjust the threshold % to tell the server when backups should pause, based on available free storage space. Backups will automatically resume when space becomes available again.

For example, if the threshold is set to 10% as pictured below, backups will cease to run when the available disk space on your server is less than 10%.

Default Backup Retention Time

We take and retain backups on the following schedule as long as the server has the available storage space as per the storage threshold setting detailed in the section above.

The following applies to both local and remote backups.

Restore Points

The following is how backups are configured if you leave the defaults as they are: 

  • We keep every restore point for up to 7 days. So, if you’ve set your site to hourly backups, we’ll be saving each hourly point up to 7 days (168 points of recovery).
  • Then we keep 1 restore point for each day older than 7 days. So we’d have 1 restore point on each day from day 7 to day 30.
  • Then we keep 1 restore point for each week for up to 6 months (180 days).
  • Then we keep 1 restore point a month up to 1 year, and we purge anything that happens to be older than a year.

Short Version Summary

  • IF HOURLY: Hourly for the last 7 days
  • Daily for the last 30 days
  • Weekly up to 180 days
  • Monthly up to a year

Any backups that are older than one year (including manual backups) are automatically purged.

You can adjust this retention period as outlined in the section directly below.

Adjusting the Backup Retention Period 

Here you can configure what type of schedule backups should take place on, and how long they should last – effectively setting how many copies of a backup to keep. This can be done inside your dashboard or set a completely custom schedule using GP-CLI.

Inside the UI within the backups Purge tab, you set the retention time for both local and remote backups in the dropdowns by defining when the system should prune (delete/remove) them:

Here you can configure what type of schedule backups should take place on, and how long they should last: –

  1. Daily backups: At least 1 backup every single day after the first 7 days
  2. Daily backups for a week and then weekly backups: At least 1 backup per week after the first 7 days
  3. Daily backups for a month and monthly backups: Backups every day for 30 days, then 1 backup for every month prior.
  4. Daily backups for a week, weekly backups for a month, and monthly backups: Exactly as described.

You can then set how long the maximum time backups can be kept for: 30, 60, 90, 180, 360 days, or keep all backups as per the schedule indefinitely.

Choose your desired settings and click Update.

Set a Custom Schedule with GP-CLI

The GP-CLI syntax for setting a custom pruning schedule is as follows:

gpbup {site.url} -set-prune-schedule {storage.service} {schedule.id} {retain.days}

This allows for a more customized schedule than using the options in the UI if they don’t quite suit your needs.

It’s important to note that setting a schedule as shown in the example below (whether custom or the same as in the UI) won’t be reflected inside the UI, but you can use the UI settings to update and overwrite your custom schedule later if you’d like to do so.


  • local
  • aws-s3
  • backblaze
  • wasabi
  • dropbox


  • 0 – daily backups
  • 1 – daily backups for a week (7 days) and weekly backups
  • 2 – daily backups for a month and monthly backups
  • 3 – daily backups for a week, weekly backups for a month, and monthly backups


The maximum number of days to retain backups for. 0 = Unlimited

Putting it all together

The following example sets the schedule for AWS S3 backups that will keep 1 backup every day for a maximum of 99 days::

gpbup gridpane.com -set-prune-schedule aws-s3 0 99

And here we’re setting local backups to take place every day for a month, then store 1 per month for 120 days:

gpbup gridpane.com -set-prune-schedule local 2 120

Purging Backups Manually

If you would like to purge backups manually to free up disk space, you can do this within your website customizer in the Backups Purge tab.

Individual backups

For individual backups, simply select the specific backup you want to delete and from the dropdowns, and then hit the Purge button.

The system will then delete that specific backup from your server or remote storage.

Mass purging backups

You can mass purge backups within the UI or via GP-CLI – whichever method you prefer.

If purging from the UI you simply need to select the data range from the UI and click the Purge button.

If using GP-CLI, the same applies, and you need to use specific date ranges. The syntax for purging from the command line is as follows:

gpbup <site.url> -purge {local/aws-s3/backblaze/wasabi/dropbox} "<date.string.from>" "<date.string.to>"

For Example:

gpbup examplewebsite.com -purge local "2021-04-28 09:00" "2021-04-29 01:00"

The date string is the literal string shown inside the UI in the dropdown, and the quotations around the date string are required.

Exporting Backups for SFTP Download

You can export any of your websites backups for download over SFTP. If you need a current backup, you simply need to take a manual backup and select it from the dropdown. If you want a copy of your site from a month ago (assuming you have backups from that time), you can download that too.

You can also choose from your local backups, your remote provider backups, and even local backups from another server. Whichever backup you need, you can download it with V2.

You’ll find the available options inside the backups Export tab:

SFTP Download from this Source

Here you’ll find the backups that have been taken for your website on this server. This includes the remote backups that have been taken of this site on this server.

SFTP Download from an Alternative Source

Click the Fetch All Potential Sources button to check for available backups from other sources.

If they exist, you will be able to select them from the dropdowns. These backups include those that exist for the same domain on a different server and remote backups that have been taken for the same domain but NOT hosted on this server.

Downloading Your Backup

To download your exported backup, you can connect to your server over SFTP:

Your backup will be available for download in the /root directory:


Backup Expiration Time

The backup you export will be available for download for the next 4 hours. After that, the server will automatically remove it.

Restoring Exported (SFTP) Backups

NOTE: For restoring regular local or remote backups, please see parts 2 and 3 of this series where we detail how to set them up and configure them.

To restore a backup that you originally exported via SFTP, you can do this by first uploading it to your websites /restores directory:


This is also detailed inside the backups tab as well:

The backup file needs to by .tar.gz format.

Once uploaded, click “No Archives Found” to check for your upload. Then select your backup and hit the Restore Now button.

Setting the Daily Pruning Time

The time that the server automatically purges backups as per your schedule can be set inside your Server customizer. Head to your Servers page inside your GridPane account and click on the name of the server you wish to configure to open up the customizer. 

In the backups tab, you can set the time you would like the daily prune to take place:

NOTE: Make sure this is not the same time that you set the automatic reboot time inside the Settings tab.\

Prune jobs run every 24 hours.

Set via GP-CLI

You also set the time via GP-CLI. The syntax is as follows:

gpbup {site.url} -set-prune-time "\{HH} \{MM}"

The time needs to be set in 24-hour format and quotations around the time are required. For example, the following would set the pruning time for 2 AM:

gpbup example.com -set-prune-time "\02 \00"

Setting Backup Concurrency

Backup concurrency lets you set how many backups can simultaneously run at the same time. For example, if you set the concurrency to 3, you’re letting the server attempt to take backups of 3 different websites at the same time (if the backup times you’ve set overlap). Backups that overlap will be queued and take place once the current backup/s have completed.

As in the section above, this can also be set inside your Server customizer. Head to your Servers page inside your GridPane account and click on the name of the server you wish to configure to open up the customizer. 

In the backups tab you can set how many backups can take place simultaneously: 

Select your desired number and click the Update button.


The number you set here should not exceed the number of CPU cores that you have on your server. If you only have 1 CPU, make sure the concurrency is set to 1. For servers with 1-2 cores, you may find leaving this setting to 1 is the best option for you.

Further Reading

For further information about how backup systems work, the available options for configuring them, and for setting up remote backups (available on V2), please see the articles listed below.


Recommended Backup Strategy

V2 Backups

V1 Backups