PluginsAppsPricingConsultingAboutBlog (opens andrewbaker.ninja in a new tab)Help Get in touch
👁28views

← CloudScale Plugin Help/CloudScale Backup & Restore, Free WordPress Backup Plugin with One-Click Restore & Cloud Sync

Dropbox

CloudScale Backup & Restore, Free WordPress Backup Plugin with One-Click Restore & Cloud Sync, Dropbox screenshot
On a phone
CloudScale Backup & Restore, Free WordPress Backup Plugin with One-Click Restore & Cloud Sync, Dropbox screenshot, as it appears on a mobile screen
The same panel at 390px, showing how it reflows. Cropped to the first screens.

The Dropbox Backup card uploads backup zips to Dropbox after every local backup. The plugin talks to the Dropbox API directly from PHP over OAuth 2.0, nothing has to be installed on the server.

App Key, the App key of the Dropbox app you create at dropbox.com/developers.

App Secret, found in your Dropbox App Console alongside the App Key.

Destination folder, path inside Dropbox where backups are uploaded. Trailing slash required (e.g. cloudscale-backups/). Leave blank for the Dropbox root.

Buttons on this card:

  • Save, stores the App Key, App Secret and destination folder.
  • Connect to Dropbox, sends you to Dropbox to authorise this site; you return here when it is done. Once connected the button becomes Disconnect.
  • Test Connection, lists the destination folder to prove the stored authorisation works. A failure shows the provider’s own error, for example an expired or revoked token.
  • Diagnose, lists the checks to work through when the connection fails.
  • Copy Last Backup to Dropbox, immediately uploads the most recent local backup zip, outside of any schedule. Does not create a new backup, it copies whatever zip is already on the server.

Before Copy Last Backup to Dropbox starts, the plugin checks how much free space Dropbox has:

  • If Dropbox has enough space, the sync starts immediately.
  • If Dropbox is running low, an inline warning appears showing MB free vs MB needed, with two options: Delete oldest (removes the oldest non-golden backup from Dropbox to make room, then starts the sync) or Sync anyway (proceeds regardless).

When connected, the card shows the destination folder, number of backups in Dropbox, and time of last sync.


Dropbox Setup Guide

Step 1, Create a Dropbox app

At dropbox.com/developers/apps click Create app, choose Scoped access and either App folder or Full Dropbox.

On the Permissions tab enable files.content.read and files.content.write, then click Submit.

On the Settings tab add this Redirect URI, with your own site’s address in front:

https://your-site.example/wp-admin/admin.php?page=cloudscale-backup&csbr_oauth=dropbox

The card’s Explain and Diagnose dialogs show the exact URI for your site.

Step 2, Save and connect

Copy the App key and App secret into the card, set a destination folder (e.g. cloudscale-backups/), click Save, then Connect to Dropbox and approve access.

Step 3, Include it in cloud backups

Click Test Connection. Then tick Dropbox Backup under Include in cloud backup in Cloud Backup Settings and click that card’s Save. Uploads, including Copy Last Backup to Dropbox, are skipped until it is ticked and saved. A skipped upload says so: tick the provider under “Include in cloud backup” in Cloud Backup Settings and click Save, and check Test Connection passes.

Connection failing? Check that the App Key and App Secret come from the same Dropbox app, that the Redirect URI matches exactly, and that both permissions are enabled. Changing permissions after connecting, revoking access or regenerating the secret needs a reconnect: click Disconnect, then Connect to Dropbox.


Running out of Dropbox space

Dropbox Basic provides 2 GB free. Backup zips for a typical WordPress site are 200 MB, 2 GB, so you may fill Dropbox quickly unless you keep your retention count low or upgrade your Dropbox plan.

The plugin detects a Dropbox quota problem in two places:

  • Before a manual backup, the cloud space pre-check warns you and offers a Free space on Dropbox button.
  • Before a Copy Last Backup to Cloud sync, an inline warning appears on the card with Delete oldest and Sync anyway options.

The Delete oldest / Free space action removes the oldest non-golden backup from Dropbox one file at a time until the required space (plus a 15% buffer) is available. Golden images are never deleted. If all deletable backups have been removed and there is still not enough space, you will need to free up Dropbox quota manually, upgrade your plan, or switch to a higher-quota provider such as Google Drive or S3.

Note: when a Dropbox account is over quota, Dropbox returns an extremely large number as the “free space” field. The plugin works around this by computing free space as total quota − used quota to detect the over-quota state reliably.

← Back to all sections